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VIEWPOINT 


by Andrew Downs 


Why I write Macintosh software 


Why do you write software for the Mae? Or t how do you judge 
your success as a software developer? ft is one of those intangible 
issues that each of us deals with occasionally. It is also what keeps 
us coming back for more when the going gets rough. 

Like many of you, my livelihood depends (at least in part) 
on the success of the Mac, Anything Apple does to enhance the 
Mac's appeal to the masses (both business and consumer) 
improves the long-term picture. The continual stream of 
innovations coming out of Cupertino gives me confidence in the 
Mac's future. The iMac and iBook, Mac OS 9, die G4, 
Quick Time.,,knowing that most of those cool technologies were 
invented or refined at Apple (or one of its close partners), leads 
me to believe that the spirit of creativity is burning brightly. As 
long as that creativity keeps getting channeled into marketable 
products, my confidence will remain strong. 

1 think my motivation as a developer stems from a desire to 
not only see something done, but to see it done right. 1 can walk 
into any computer store or office and see hardware and software 
that is acceptable. But when I fire up my iMac, or my 
PowerBook, or my 6100 (considering its age) I see something 
that was done right. It just kicks ass. 

Sometimes this motivation borders on fanaticism. For example, 

I would guess that most software gets written during non -work 
hours, (This hypothesis is simply based on the sheer numlx-r of 
frex* ware/shareware vs. commercial titles, 1 could l>e wrong.) Have 
you ever tried explaining what you do during the hours when most 
people are sleeping, and received an uncomprehending stare? 
There is something about this business that probably Ixiffles most 
outsiders, but is obvious To tile participants: this is a seriously 
cerebral endeavor, and it is easiest when the outside distractions 
arc: fewest. For some people, that’s the middle of the night 

Plus, when you’re caught up in the excitement of adding the 
latest and greatest feature Lo your new project, it is very difficult 
to stop, Have you ever tried halting a twenty-file debugging 
session in the middle and coming back ten hours later? The 
computer may still be in the same state, but ynm mind needs 
time to reacclimate to the situation. (Developer conferences 
reinforce this non-stop programming mode, although someone 
once remarked ilia! it’s gotxl that Mac Hack only lasts three days, 
otherwise he’d lx- dead due to lack of sleep.) 

Some developers have tremendous vision, always 
knowing exactly where their project is heading. For the rest 
of us, it can be hard to explain what youTe trying to do when 
you’re discovering as you go. But eventually the vision (and 
product) lakes shape. When you do reach your goal, and 
deliver version 1.0, it alt becomes worthwhile. 


Writing Macintosh software bis always been, lor me, a process 
of learning by doing. Although you can find Macintosh software 
development courses offered professionally or at some universities, I 
suspect most programmers learned the intricacies of Macintosh 
programming through hands-on experienc e, f spent a lot of time 
reading and experimenting for a few yeans, I originally (and naively) 
expected it would take a few months to master the Mac, Now 1 see 
no end in sight, which ! find very encouraging, ’there is always 
something new to learn. 

Software development, both now and in the foreseeable future, 
is Iry no means a simple endeavor. I think the ascendance of 
internet time” lias made it more difficult to master development 
skills, not for technical reasons, but lxx.itu.se the jx-icdvcd need for 
immediate payback warps one s judgement and patience. 

In addition, the delivery mechanism lor programming materials 
has changed over the past five years. Printed material has declined, 
and electronic files have proliferated. Tlie increased nuinlxT of 
online tutorials partially compensates for the decrease in the number 
and variety of Macintosh programming books, but there’s often a lot 
of noise mixed in with the signal. And since Lire underlying 
technology gets more complicated everyday, we continually need 
.simpler APIs and programming languages to help ease the burden. 
It may lie a little tough for new devdofxnc On the other hand, if ii 
were easy, everyone would lx* doing it. 

These days 1 spend most of my time working with 
CodeWarrior and MR). I write more Java than C/C++, building 
applications rather than system extensions, and I’m learning 
Miffs strengths and weaknesses. Apple's java offering has 
come a long way in the last few years. The performance of the 
current release on my iMac is great. I hit like many other 
developers, 1 am eagerly anticipating the version they decide 
to release with OS X, Although Apple isn’t committing at this 
time, I'm hoping for java 2 compatibility. 

This industry is unique in its willingness to let the future lx 
directed by relative newcomers. Txlay's ideas are tomorrow’s 
products, (And sometimes, today's engineers are tomorrow’s 
millionaires. Jhat can lx* attractive too,) Hie result is a continual 
influx of fresh ideas and lit lent that eliminates .stagnation and 
generates eonifxtilion. As developers we need to encourage this 
process. After alt, thinking different is the essence of the Mac. 

In the end, for me it boiLs down to making a difference in 
peoples* lives. If I an make someone’s online time more fun or 
productive, or their life easier, then I’ve succeeded. When 1 receive 
email about software I've written, 1 know I’ve touched someone. 
And, it keeps me coming back for more, 10 
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Question: Is MacHASP USB* a full sales potential - without 

software security key or a getting in anyone's way. Call now 

sales tool? to request a Developer’s Kit and 
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software protection key for the 
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Mac software protection provider, Micro Macro Technologies, becomes part 
of Aladdin, giving Its customers even better service from the number one name. 



GETTING 

STARTED 


by Dan Parks Sydow 


Writing Programs That Speak 


An introduction to including speech in a 
Macintosh program 

In February and March of last year. Getting Started discussed 
how a Macintosh program plays pre-recorded digitized sounds, in 
April’s article we looked at how a program can record and later 
play back sounds — including speech. But there’s another way — 
an easier and disk space-saving way — to give your Mac 
application speech capabilities. This month well look at the Speech 
Manager and hew its functions allow your program to easily 
generate spoken words. In the example program you 11 see that the 
words that are to be spoken can be supplied in a variety of ways; 
either by hard-coding them in your program, including them in 
strings in a resource, or by allowing the user to enter them. 

Speech Basics 

A program that includes the ability to generate synthesized 
speech — speech that results from the conversion of text to 
spoken sound — uses the Speech Manager The Speech Manager 
accomplishes this with the assistance of a speech synthesizer The 
Speech Manager passes text to a synthesizer It is the synthesizer's 
built-in dictionaries and sets of pronunciation rules that enable 
text to lx: processed and turned into recognizable speech. After 
the synthesizer does its job, it passes_the converted data to die 
Sound Manager for output to the Mac's audio hardware. 

The Speech Manager, speech synthesizers, and the Sound 
Manager are all system software. As is often the case in Mac 
programming, to achieve your results you won t have to know 
all the details of the system software dial does the dirty work. 
Instead, you’ll become familiar with the Toolbox functions that 
serve as your interface Ixaween your programming ideas and 
low-level code that carries out your wishes. 

Initializations 

Most programs don’t make use of speech, so the function 
prototypes for the speech-related Toolbox functions may not 
automatically be included in your CodeWarrior project To ensure 
that they are, include die Speech. h universal header file near the 
top of your source code: 

//include <Speech*h> 


If your program is to make use of a speech synthesizer, it 
needs to verily that the host computer supports speech. To do 
that, fx:gin with a call to Gestalt(): 

OSErr err; 
long response: 
long mask; 

err “ Gestalt( gestal tSpeechAttr. ^response ); 
if ( err !- noErr ) 

EoError( ‘"XpError calling Gestalt* ): 

If GestaltQ does its work without fail, it puts a value of noErr 
in the OSErr variable err. Then ifs time to examine the value 
returned in response; 

mask « 1 « gestaltSpeechMgrPres&nt; 
if { response fr mask = 0 ) 

DoErrar{ ’‘VpSpeoch Manager not present " j; 

The gestaltSpeechAttr selector code results in Gestaltfi 
returning more than one piece of information in response. Here 
we're only interested in whether the system the program is 
running on has the Speech Manager present. That information is 
held in one bit in the response parameter — the bit defined by 
the Apple-defined constant gestaltSpeechMgrPresent. To 
determine if one particular bit in a variable is set (on), a logical 
AND operation is necejssary. In die previous snippet we're 
looking to see if the bit number defined by the constant 
gestaltSpeechMgrPrGsent is set in die response value returned by 
GestaitQ. Some bit-shifting sets up mask so dial it can be used in 
the test of response. If the logical AND operation results in a non¬ 
zero value, then the test passes and we know the user's machine 
supports speech. If the operation results in a value of 0, DoError(> 
is invoked to post an error message and to exit. 

Getting used to bit shifting takes some people a little 
time and practice* If the alcove explanation isn't clear, read 
this extra explanation. 

A function may return a variable that embeds several pieces 
of information in that one variable* ft does this by having 
different bits in the variable represent different things. That is, 
several or all of the individual bits in the byte or bytes of the 
variable tell the program whether certain things are true or not* 
A variable of this type may consist of any number of bits. If such 
a variable is declared to be of type short, it is eight hits, so it 
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can hold up to eight pieces of information (often referred to as 
flags). If hie variable is declared to lie of type long, it is 32 bits, 
so il can hold up to 32 flags. Consider if the eight bits of such a 
variable look like this: 

00100011 

lilt numbering is from right lo left, with the first bit considered 
bit number 0. In this example bit 0 has a value of 1, bit 1 has a 
value 1 of 1, bit 2 has a value of 0, and so forth. If we want to know' 
the value held in bit 5, we'd need to look at the sixth bit from die 
right, Starring with the rightmost bit and counting from zero we see 
that bit 5, the sixth bit, has a value of I. You can easily see this, 
but die program needs to use a mask and the logical AND 
operation to determine this. By placing a value of 1 in bit 5 (die 
sixth bit) of a mask variable, and then ANDing tliat mask with a 
variable tliat holds a number of flags, die value of only the sixth 
bit of the variable is revealed. Here the above variable is ANDTd 
with a mask that lias just die sixth bit set: 

00100(111 (variable value) 

& 00100000 (musk value) 

00100000 (result of AND) 

An AND operation looks at die corresponding bits of two 
operands and returns a value of 1 for that bit position if and 
only if both bits have a value of L In the above example, only 
bit 5, the sixth bit from the right, has a value of 1 in both 
operands. That's shown in the result, which has only a single 
value of 1. To make use of our result we simply check to see 
if die overall result is greater than or equal lo 0. If the bit of 
interest was 0, then the result of the AND operation would be 
0. If the bit of interest was 1 T then the result of the AND 
operation would be greater than 0 (the exact value of the 
result would depend on which bit position held the value of 
1, bur in any case the result would be greater than 0, Refer 
back to the speech check to see that we don’t care about the 
exact value of the result of the AND operation — we only 
care whether the value of the result is or isn't 0. 

Speaking a String 

The SpeakStringQ function is a Toolbox routine that 
makes speech easy to accomplish. Pass this function a 
Pascal-formatted string and SpeakStringf) sees to it that the 
text that makes up that string turns into speech that emits 
from the user’s Mae, Here’s an example: 

GSErc err: 

err " SpeakStringt “\pTbis is a test." ): 


The string that's passed to SpeakString{) can also be in the 
form of a string variable or constant, as in: 

Str255 theString = *\pThis is another test." ): 
err - Speak$tring{ theStritig ); 


Ji’s good programming practice to check die QSErr value 
tliat SpeakStringQ returns. Your program can handle an error as 
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it sees fit — Ill handle such an error by passing a descriptive 
message U> my own DoErrar<) error-handling function: 

if t err != notfrr ) 

f)oError( "\pError attempting to speak a phrase" ): 

Tlie Speech Manager produces asynchronous speech. 
Asynchronous speech means that before a call to SpeakStringO 
completes, control is returned to your program. That means dial 
the code following a call to SpeakStringO could very well start 
executing before a spoken phrase is completed. That might be 
okay, but it could also produce unintended results. For instance, if 
your program speaks two phrases in a row, Ixnh phrases may not 
be heard. To avoid this situation, force your program to generate 
synchronous speech. That is, have your program speak a string 
only after a previous string lias been completely spoken. To 
accomplish this, have your program enter a "do-nothing 17 loop after 
speech starts, You can easily determine when this loop should 
terminate by using the Speech Manager function SpeechBu$y(): 

while { SpeechBusyO = true ) 


Because the SpeakStringO generates speech asynchronously, 
the while loop begins executing almost immediately after 
SpeakStringO Ix^gias executing, SpeechBusyO returns the number of 
active sfteech channels. A speech channel Ls a data structure dial 
keeps track of traits of speech, such as die voice to be used for 
speaking, When SpeakStringO executes, it opens a speech channel 
When SpeakStringO completes, ii closes that channel If SpeechBusyO 
is called while SpeakStringO is speaking text, SpeechBusyO returns a 
value of 1 (or mom Lhan 1 if udier speech channels happen to be 
active at the same time). When SpeakStringO completes, a call to 
SpeechBusyO returns a value of 0, Knowing this, you can opt to 
replace the atxwe snippet with the following code (my preference 
Ls to List true for clarity, but the choice Ls yours to make) 

while ( SpeechBusyO > 0 ) 


While SpeakStringO i* executing, SpeechBusyO keeps 
returning a value of 1 and the while loop keeps cycling. Only 
when speech completes will SpeechBusyO return a value of 0, 
and only then will the white loop terminate to let die program 
go on its way. 

Let's pul the above code snippets together to see just how 
a complete string of text is spoken; 

OSErr err: 

err = SpeakS iring( “\pThis is a test." ); 
if ( err 1= nuErr ) 

DoError( "\p.£rn>r attempting to npeak a phrase' 1 ); 
while ( SpeechBusyO = true ) 


SPELOilNTRO 

This month’s program is Speechlntro* As has become our 
habit, the example program doesn't make use of menus. 
Instead, the focus is on the speech-related code rather than 


menu and event code, Speechlntro demonstrates how a 
program can generate speech from hard-coded text, user- 
entered text, and resource-supplied text. When mn, 
Speechlntro stans by speaking tw r o phrases. Just after 
launching Speechlntro you'll hear your Mac say "This is the 
first phrase," A moment later your computer says "And this is 
the second phrase. 1 ’ After that a dialog box like the one shown 
in Figure 1 appears. Here you supply the text to speak. Enter 
a few words, then click the Speak button to hear those words. 
When finished, click the Done button to dismiss Lite dialog box 
and to bring on a second dialog box. This one (shown in 
Figure 2), lets you hear speech iInn originates as string 
resources. After clicking the Speak Short String and Speak Long 
String buttons, click ihc Quit button to end the program. 


Eater a won! or sentence to speak: 




Speak me! 




! Speak 

j 

| Done | 





Figure i. Entering a phrase for Speechlntro to sfmak. 


Speak Short String 

J 


Speak Long String 

J 


i m ) 


Figure z Listening to speech generated from resources. 


Creating the SpeechIntro Resources 
Begin by creating a new loftier named Speechlntro in 
your Code Warrior development folder. Start up ResEdit and 
then create a new resource file named Speech Intro, rsre. 
Specify that the Speechlntro folder serve as the resource file’s 
destination. This resource file will hold resources of the types 
shown in Figure J. 


Speech introxsrc 







EH 

5- 

U3 Hi 

ALRT 

Dm 

DLQO STR* 


□ mu 

DLOGs from Speech rntn>,rsrc 0 § 

- 

ft 


Stze Niro* 





129 


21 



#■ 


130 


21 





Figure jl The Speechlntro resources , 


The resource file will hold one alert resource -— ALRT 128. 
Corresponding to this ALRT is DITL 128. Together these two 
resources define the program's error-handling alert. The resource 
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file also holds Lwo dialog resources — DLOG 129 and 130 and a 
DITL resource for each DLOG {DITL 129 ami 130). Figure 4 shows 
DLOG 129 —* the DLOG resource that’s used to define the look of 
the dialog box shown track in Figure I. Note that the type of 
dialog lx>x. and its exact size and .screen placement, aren’t 
relevant, Figure 5 shows the corresponding DITL resource. 


OLOGIDt 129 from Spee 


□□□□□□□■bee 



tulur ft Drfmilt 
O (iuvLuin 


DIR ID; 1120 


□ Initially vifiblP 
0 (Jose Box 


TOP" W | Height: |72Q I 


Figure 4 7he DLOG for the text input dialog box. 



Figure 5. The DITL for the text input dialog box. 

DLOG 130 defines the look of the program's second dialog 
box — the one shown back in Figure 2. Again, the type, size, 
and placement of the dialog box resulting from DLOG 130 aren’t 
critical. Figure 6 shows the DITL that corresponds to DLOG 130. 



Figure 6. 7 he Dili for the resource-supplied text dialog l?ox. 

Clicking on either the Speak Short String or Speak Long String 
in the dialog ix>x shown in Figure 2 results in the program reading 
a string from one string list resource — STR# 128. Figure 7 shows 
the two .strings that reside in tills one resource* 
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Figure 7. The STR# used by the resource-supplied text dialog box - 

CREATING THE SPEECHlNTRO PROJECT 

Create a new project by launching CodeWarrior and then 
choosing New Project from the File menu. Use the 
MacOS:C_C++:MacOS Too!box:MacOS Toolbox Multi-Target 
project stationary for the new project. Uncheck the Create 
Folder check box before clicking the OK button. Now name 
the project Speech! ntramcp, and make sure the project's 
destination is the Speech Intro folder. 

Next, add the Speechlntro.rsrc resource file to the project 
Remove the SiHyQalls.rsrc file. Feel free to remove the ANSI 
Libraries folder from the project window If you want, as this 
project doesn't use any of these libraries. 

If you plan on making a PowerPC version (or fat version) 
of the Speechlntro program, make sure to add the SpeechLib 
library to the PowerPC targets of your project. Choose Add 
Files from the Project menu and maneuver on over to Lhis 
library. You’ll find it in the Metrowerks CodeWarrior:MacOS 
Support:Librarie$:MacOS Common folder. If you don't find the 
library in that folder, use Sherlock to search your hard drive 
for it. When you add the library to the project CodeWarrior 
displays a dialog box asking you which targets to add the 
library to. Check the two PPC targets. 

Now create a new source code window by choosing New 
from the File menu.. Save the window, giving ir the name 
Speechlntrox, Choose Add Window from the Project menu to add 
Lhe new empty file to the project. Remove die SillyDalls.c 
placeholder file from (he project window. Now you're all set to 
type in the source code. 

If you want to save yourself some work, connect to the 
Internet and head over to MacTech’s ftp site at 
ftp://ftp.maaeth.tom/src/. There you'll find the Speechlntro source 
code file available for downloading. 

Walking Through the Source Code 
Speech I ntro.c starts with the inclusion of the Speech, h file. If 
you attempt to compile the file and you receive a number of 
errors related to undefined functions, then you forgot to include 
this universal header file. 

^Mwnwim w wm **■ ■ Liuiiuiiiuii^ 

fl include <Speechdi> 


After the include come a number of constants, lhe constant 
kALRTResID defines the ID of the ALRT resource used to define 
the error-handling alert. Constant kDLOGUserResID defines the ID 
of the DLGG resource used for the dialog box that accepts user 
input. ‘Ihe constants kSpeakButton. kDoneButton, and kPhraseEdit 
are constants denoting the item numbers of the three items in die 
user-input dialog Ijox. The constant kDLGGStringsResID defines 
die ID of die DLOG resource used for die dialog box that makes 
use of resource-supplied strings, lhe constants kSpeakShortButton, 
kSpeakLongButton, and kQuitButton correspond to the item 
numbers of die three items in dial dialog box. The program's two 
strings are stored in a STR# resource with an ID of 
kStringUstResID. The two strings are items number kShortStrlndex 
and kLongStrlndex in die string list resource. 


#* nii«*tHtiit*n ■# COn^tStlt^ fiflttiiKfliiitautiii^ 


J/def tne 

kALRTReslU 


128 

//define 

kDLOGUserResID 


129 

//define 

kSpeakButton 


1 

//define 

kDoneButton 

2 


^define 

kPhraseEdit 

3 


^define 

kDLOGSt. r i ngB Re b ID 


130 

Udefine 

kSpeakShortHuUou 


1 

//define 

kSpeakUmgfiu t tori 

2 


//define 

kQuitButton 

3 


//define 

kStringListResID 

128 

//define 

kShortStrlndex 


1 

(/define 

kLongStrlndex 

2 



Next come the program's function prototypes. 

funciions 

void ToolBoxInit( void )i 
void SpeakCodeStringsC void ); 

void SpeakUserInputStrings( void J; 

void SpeakResourceStrings! void 1; 
void DoErrort 5tr255 errorString ): 

The main() function of Speechlntro starts with the 
declaration of two variables that are used in the determination 
of whether speech generation is possible on the host computer. 
After die Toolbox is initialized and the speech-related tests are 
made, three application-defined functions are invoked. 
SpeakCodeStringsO demonstrates how a program speaks text 
that originates as strings hard-coded into the program, 
SpeakUserlnputStringsQ provides an example of how a program 
accepts texL from the user and then speaks that text. Finally, 
SpeakResourceStringsO shows how a program can load, then 
speak, the text from items in a string list resource, 

main ***"*" w * w 7 

void main! void ) 
t 

OSErr err; 
long response; 
long mask; 

TooIBoxInitt): 

err - Gestalt ( gestalfSpeeehAttr ( ^response ); 
if { err t“ noErr } 

DoError( "VpError calling Gestalt 1 * ); 

mask = 1 « gestaltSpeechMgrPresent; 
if ( response h mask “ G ) 

DoBrrort '"NpSpeech Manager not present “ ): 
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SpeakCodeSrrmgs 0; 
SpeakUsor I input Si rings £); 
Speakliei3otirteSLriiigs() : 


ToolBoxInit() remains the same as previous versions, 

/ ww ™™ ,T *Tix>IBoxlnit 111,1,11 .. 

void Tool BoxTni1( void ) 

I 

luitGraf( feqd.thePort ) 

InitFontsO : 

InitWindows O ; 

InitMenusO: 

TEInitOi 

InitDIalogst nil }; 

TnltGursor(); 


SpeakCodeStrings() uses calls to SpeakS1ring() to speak text, 
and SpeechBusyO to time ihe start of one speech with the end 
of another. The code in SpeakCodeStringsQ was covered in detail 
earlier in this article. 

Spriik(4HjcString, *h,j—j— 

void SpeakCodeStrings! void ) 

i 

OSKrr err; 

err = SpeakString( “\pThis is the first phrase." ): 
if ( err 1- noErr ) 

DoError( *\pError attempting to speak a phrase" ); 
while ( SpeechBusyO “ true ) 

err = SpeakStringf "\pAnd this Is the second phrase." ); 
if t err 1= noErr ) 

DuErrorf "\pError attempting to speak a phrase" J; 
while [ SpeechBusyO *** true ) 


SpeakUserlnputStringsO opens and controls a standard 
modal dialog box, SI you’ve ever included a non-movable dialog 
box in any of your own programs, or if you read last month’s 
Getting Started article on QuickTime, then most of the 
SpeakUserlnputStringsO code should look familiar to you. The 
function logins with a number of local variable declarations. 
After that the dialog box is opened and displayed: 

Speikt ktfnputftrtng* ,T,,T,tT """V 

void Speakllsetlnput Sitings ( void ) 

( 

DiaiogPtr theDialog; 

Boolean done - false; 

short item; 

short type; 

Handle handle: 

Rod red; 

Sir2!i!i theString; 

OSErr err; 

theDiaiog - GetNewDiaiog( kDEOGUserRestD. nil* 

(WindowPtr)-IL ): 

ShowWindow( theDialog ); 

SetPort( theDialog, ): 

Next, SpeakUserlnputStringsO enters a lcx>p that executes until 
the dialog box Done button is clicked. When the user clicks the Done 
button, the load variable done gets set to true, the loop ends, and 
the dialog !x)x is dismissed. Each call to die Toolbox function 
ModaiDialogQ returns the item number of a clicked on item (if in fad 
any item Ls clicked on). This item number is used in a switch 
statement to determine how rbe mouse click is to be handled. 


while ( done ~ false J * 

I 

HodalBialogC nil* &ite® ); 
switch ( item ] 
t 

case kSpe.akButton: 

Get DialogTt cm ( fheDia 1og. k Ph ra seHdIt, &t ypc, 

{(handle, &rect ); 

GetUiiiiogiceKfl'ext( handle. theString ); 
err = SpeakStringC theString ]; 
if ( err I™ noErr ) 

DoErrorf "\pError attempting to speak a phrase" ); 
while ( SpeechBusyO = true ] 

break; 

case kUoneBuLlun; 
done = true; 

break; 

1 

3 

DisposeDialog( theDialog ): 

I 

A click on the Speak button results in a call to the Toolbox 
funcLion GetDia3ogltem{), This function returns information about 
the clicked-on item, including a handle to the item. We’re 
interested in that handle, which we use in a call to 
GetDiabgltemText(). This routine gets a copy of the texr that's 
currently in the text item referenced by the supplied handle. This 
routine also returns that text to the program in the string variable 
theString, The text in this string Ls then spoken by making a call 
to the very handy SpeakStringO fund ion. 

A click on the Done button dismisses this dialog box. It 
also returns control to main() P where a call to 
SpeakResourceStrings{) is made. 

The SpeakResourceStrings() routine is set up similar to the 
SpeakUserlnputStringsO function: several local variables am declared, 
a dialog box is opened, and a loop Ls performed to check for mouse 
button clicks on items in the dialog box. 

SpejikRt^HirtvSrrings * * * * »» 

void SpeakResoureeStrings ( void ) 

I 

DialogPt r theDia1og; 
short item; 

Boolean done = false; 

Str255 theString; 

OSErr err; 

LheOialog _ GetKewDialogi klMXl S t rings ties I i). nil. 

(WindowPtr)-1L ); 

ShowWindov( theDialog ); 

SetPort£ theDialog ); 

while ( done = false ) 

1 

HodalDialog! nil, &ileni ); 
switch ( item J 

( 

case kSpeakShortButton: 

GetIndString£ theString, kStringListResID. 

kSbortStrIndex ); 
err - SpeakStrIng( theString ): 
it ( err noErr ) 

DoErrort M \pError attempting to speak a phrase" ); 
while f SpeechBusyO = true } 

break; 

case kSpeaktongButton: 

GetlnciStringC theString, kStrl ngT, l stResTD. 

kLongSirIndex J: 
err = SpeakString£ theString ); 
if ( err t= noErr ) 

DoErrort "VpError attempting to speak a phrase" ); 
while ( SpeechBusyO = true } 

break: 
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case kQuitButton: 
done *» trues 

J 

I 

OlapoaeDialogt theDialoft ): 

I 

SpeakResourceStrings() relies on the Toolbox routine 
GetJndStringO. If the user clicks on the Speak Short String 
button, the kSpeakShortButton ease section executes. Here a 
call to GetlndString() returns the string that’s defined as the 
first item in the program s string list resource. That returned 
string is then passed to the SpeakStrtng() function to be 
spoken, A dick on the Speak Long String button res nils in a 
similar action — the difference being that the program ends 
up speaking the second of the two strings stored in the 
program's SIR# resource. When the user is finished 
experimenting wiLh this dialog box a click on the Quit button 
dismisses the dialog box and ends the program, 

DoErrorQ is unchanged from prior versions* A call to this 
function results in the posting of an alert that holds an error 
message. After the alert is dismissed the program ends, 
pp.Muu.Mi4t,,,. DoErrwr 

void DoKrrort 5tr2bh errorString j 
{ 

PututriText ( etrorString, “\p". *\p F . M \p” ); 

SiopAlert( kALRTResID, nil ); 

KxitToShellC); 

) 


Running SfeechIntro 

Run Speechlntro by choosing Run from Code Warrior's 
Project menu. After the code is compiled, CodeWarrlor runs 
the program. After the program speaks two phrases, the 
dialog box shown back in Figure 1 appears. After entering 
some text to speak, and then clicking the Speak button, you 
slit mid be satisfied that user-entered text can result in spoken 
words. After clicking the Done button you see the dialog box 
shown back in Figure 2 Click the buttons to hear the text 
stored in the program's resource file. When finished, click 
the Quit button to exit the program. 

Tiu, Next Month,,, 

Like movie-playing, speech is a nifty technology that 
adds flair to your program. Speech won't always be 
necessary t but when planning out your next project you 
should closely examine the things your program is to do, and 
see if any parts of the program could be enhanced by the 
inclusion of speech. 

In this article weVe touched on the basics of speech. As 
you can imagine, there's much more to Apple's 
implementation of speech, including speech channels that 
allow for variations in speech, and voices* Next month well 
explore these topics so that your program can really take 
advantage of the power of the spoken word..* M 
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HARDWARE 


by Neil Ticklin, Publisher 


Going Wireless! 


Every once in a while, a 
technology so grabs my attention, I 
just want to dive right in and play with 
iL In short, wireless is one of those 
technologies and its just plain cool! 

Today, connec tivity is no longer 
a luxury — it's a requirement. It’s 
not a matter of if you're connected 
at a specific location, but instead 
how much bandwidth and the type 
of connection you have. There are 
many options for bandwidth. 
Wireless has really matured and is 
frankly, an excellent, cost effective 
solution that should be put into play 
whenever it makes sense. 

This article is going to take you 
through a real life scenario for 
replacing dedicated Frame Relay 
lines with wireless. Because wireless 
is relatively simple, this article will 
focus on the process and the results. 
If you are interested in die 802.11 
standard and more technical 
information, look at the article in die 
December, 7999 MacTeeh which 
covers these tn depth. 

Why Wf/rf. Running Away from 
Wires and Tel-Cos 

For years. I've relied on Frame 
Relay to connect my home to the 
office, and the office Lo the Internet. 
For us, PacBell's Frame Relay 
network has been, let's say, less 
than reliable. So, we were eager to 


find a new solution. At the time we put in our Frame 
Relay WAN (1995), it was really the only option that 
made sense for us. Today, VPNs, DSL and wireless have 
really eliminated the benefits that Frame Relay had for 
us, And, most of these give you Lite opportunity to get 
away from phone companies, monthly fees, and 
more... a big plus in my book. 

Some Wireless Basics 

Spread-spectrum radio based systems like the Lucent 
Wave LAN are cost effective solutions that don't require 
an FCC license. The range can vary substantially — up 
to 40 miles with amplifiers, and easily within several 
miles. You can transmit at up to 11 Mbps using a signal 
that has a high resistance to interference. 

Without encryption, there's still a fairly high level of 
security due to the spread-spectrum nature of the 
transmission algorithm. First, an interceptor would have to 
be in the line of sight. Then, they would have to find a 
matching frequency. They would also need to know 
network names, MAC addresses, and more, making tilings 
relatively secure. If that isn't enough for you, 64-bit key 
encryption is available, with 128-bit coming soon. 

Getting the Right Help 

If you are just setting up a short distance outdoor point- 
to-point connection, it will be easy. Why? There’s so much 
extra signal, problems just don't show their face much. 

Likewise, if you are going lo set up an indoor wireless 
IAN with a Apple’s AirPort or Lucent’s Wave POINT, iL’s easy 
Lo do, and you should proceed without worry. 

But, if you are going to do anything more complex 
than that, a tougher line of sight, or longer distance 
than 1/2 a mile, you should really look to have advice 
available to you. 


Neil Ls the Publisher ol MacTvcb Magazine and the CEO of Xplain Corporation. He’s been around the Mac developer 
community for many years with his first Mae program shipping in 1985. And, while he doesn’t get to do as many technical 
projects as he would tike, he does occasionally get to be a geek on projects like this wireless article. 
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One of rhe most knowledgeable wireless distributors 
out there is Winneom Technologies. They were 
recommended by several folks Lhat T spoke to, and have 
solid relationships with Lucent, Aironet, BreezeCom, and 
others. They have everything and anything you need, 
from connectors to cables to antennas to the bridge and 
radio hardware itself. They will help you with site 
analysis, signal loss calculations, equipment choices, 
etc... A lot of what you learn in this article comes from 
what 1 learned from them. If this sounds like a 
commercial, it's because they were incredibly helpful, 
and knowledgeable and I would just assume that you 
have the same experience. Don't, hassle me for touting 
them — believe me, they deserve the recognition. 

You can reach them at: Winneom Technologies, Inc., 
30700 Carter Street, Suite A, Solon, OH 44139, Toll Free: 888- 
WUNNCOM (888-946-6266), 440498-9510, Fax: 44049&- 
9511, <mailto:sates@winncom.com>, <http://www.winncom.com/> 

The Wireless Solution: Dollars and Sense. 

With an off the shelf wireless setup, wc were able 
to replace our Internet connection with an 11 Mbps 
wireless connection fairly easily. The bigger challenge 
was in connecting my home to the office... which 
didn’t have line of sight. 

For the Internet connection, we’ve been paying $500+ 
per month for a T1 Frame Relay (not including any costs 


tor the Internet access itself), plus the initial cost of 
hardware. IX Mbps point-to-point wireless connections, 
can be done for as little as $2000-53000 in hardware and 
installation -— giving us a payback time of 6 mom I is 
compared to just the TL One more thing: The wireless 
connectivity roughly equates, in real life, to three to four 
Tls worth of bandwidth... with no monthly costs. 

For a WAN connection (such as my home to the 
office), we were doing a 56 Kbps Frame Relay connection 
(yeah, yeah, I know it’s slow — but remember, 56k was a 
lot 4.5 years ago). This cost $125 per month, plus the cost 
of a router ($2500 then, probably $1000 now) and the 
Frame Relay installation {$1000). 

Since we didn’t have line of sight from my home to the 
office, we put in a relay point up on a hill that did have line 
of sight to both my home ami the office. In our case, we 
mounted the antennas on this bouse up on the hill (giving 
them great Internet access in the process). Even in this 
more expensive scenario, this can be done for as little as 
$5000. That may sound like a lot, but when Frame Relay is 
unreliable, dedicated Tls are $1000, 128K DSL is the max, 
and there are no cable modems... it looks like a pretty 
good option if you need the bandwiclih. 

The Test 

We took a Look at two product lines — the Lucent 
WavcLAN <http://www.wavelan.com/> and the Aironet 


Are you lost out there ? 


Can't find anyone to help you get your product to market ? 



eeHlve Technologies Inc., The 
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<http://www.aironeT.com/>. As a side note, Aironet was recently 
acquired by Cisco. I loth of these products are solid prcxkicts 
tliat do the job well and are welcomed in our network. 

There arc a few primary differences between the 
Aironet and the Wave LAN. The Aironet is a point-to- 
multipoint bridging solution which allows one 
antennae and one Ethernet connection on each bridge. 
In addition, the radio is integrated into the bridge, so 
there’s not an easy upgrade path, This is a nice, clean 
product that is pretty simple to use. The product uses 
a telnet interface for configuration. 



A ironet HR500H. 


Lastly, the Aironet radio is about two times the 
strength of the Lucent Wave LAN. By contrast, the 
WaveLAN tends to be a more sensitive radio not 
requiring as much power. Either approach works very 
well. In case you are curious, all of these are low power 
devices. While they are microwave, they are only 
putting out 30m’W or so... so don't plan on cooking 
your chicken on stick in Front of them. :) By contrast, 
my Nokia cell phone outputs up to 600mW nominal. 

The WaveLAN separates the radios from the chassis 
and can have two radios per bridge. The radios are 
actually just PC Cards. 


k i i 1 


s 



Warn POfNidi Access Point / Point-to-Point Bridge . 


In fact, you can take the PC Cards out and just put 
them in your laptop. This allows for easy upgrades 
(e.g., from 2 Mbps to 11 Mbps), and swapping of 
equipment as well. The one downside is that to attach 
an external antennae or an extender antennae, you 
have to use a pigtail” that you need to be careful with. 
We accidentally broke the tabs off of one and had to 
replace it. To me, dealing with this connector is 
worthwhile trade off to be able to use the PC Cards in 
the chassis and in my laptop. Given how small a PC 
Card is, and that you have to plug the antennae into 
the side of the card, it would be difficult for the 
connector to be anything more than it is. 

Because it can have two radios, the WavePGINT-il 
allows you to use it as both an access point for your 
indoor wireless LAN at the same time as your external 
point-to-point connection — as we did. Or, you can use 
ii as a relay point using two external antennas to get 
signal to a third location not in line of sight with the first 
— as we did as well. In general, I prefer the WaveLAN 
design approach which gave us incredible flexibility. 



WaveLAN PC Card . 


Site Survey 

Before you go spending a bunch of time in looking at 
wireless equipment, your first step should be to figure out 
whether you can do wireless with a basic *site survey”. 

The primary thing wiili wireless is making sure that 
you can have a good signal path. This not only means 
visual line of sight, but radio line of sight. And, you 
need to make sure that you have enough height, and 
won't have issues wiLh interference. 

Visual line of sight means exactly what you think 
— can you see dearly from one point to the other. 
While it is possible to gel the radio signal to bend 
around things, it is something that you really warn to 
avoid Land leave to the professional radio installers). 
Optimally, you want to have a completely clear path. 
(See Radio Line of Sight diagram), to take into account 
tlie path of the signal. 
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SPI tracks down software pirates 
with every illegal click. 

SPI adds a protective layer to your program that allows only those end-users who legitimate¬ 
ly purchase your software to install it. No mailer how many copies of your program get 
distributed illegally only the valid purchaser can install and run your product. 

For just pennies a copy, you can protect all your products and significantly 
increase your revenue without increasing production costs. 

Features: 

* Win95, Win9K, Win2000, WinNT, Mac/PowerMac ■ Resource Encryption 

* Key File Encryption * 3 Built-in Demo Modes * Built-in Online Registration 

* Built-in General Purpose Registers * Distribute via CD/DVD, Diskette, Internet 

Sell your software without 
a shopping cart. 

With SPI's built-in a-Commerce feature, distribute and sell your software in one easy step. 

Your customers simply download your SPI protected product and select Purchase 
when they run the installer. After entering their credit card information, SIM uses 
identity authentication, packet encryption and a secure link between SPI and the 
authorizing agent to protect the transaction. Upon authorization, your product is 
installed and ready to run. You can even set up a ‘try-before-you-buy” demo that 
can then be upgraded using SPFs e-Corn merce feature when the demo expires. 

Features: 

* Real-Time Authorization thru CyberCash™ or Authorize,Net™ • No Web Store 
Front Required * 3-tier Transaction Protection * Upgrade Demos to Full Version 
from Original Product Installer Download * Purchase/Tracking Reports Provide 
Additional Credit Card Charge-Back Protection - Reduces Web Hosting Charges 

No special hardware required. 

SPI doesn't require expensive hardware keys or dongles to protect your software. Besides, 
you can't download a dongle, SPT uses an encrypted software lock to protect 
installed tiles. Once a legal product is installed, SPI’s Lock Point feature prevents 
illegal copies from running on any other computer, while SPI'S uninstall feature 
allows end-users to move a protected product to another computer. Simply run 
the installer again and SPI disables the first installation, allowing the software 
to he installed on another computer. 
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See for yourself how SPI 
protects your products. 

Visit our web site at www.nwspi.com to request our SPI Evaluation Kit. The SPI 

Evaluation Kit will allow you to protect one of your software products for 
up to one month. Each Evaluation Kit comes complete with Lhe crass-platform 
SPI software, APIs and the SPI User’s Guide outlining all of SPIs features. 
You can test every feature of SPI, including the built-in e-Com merce feature 
with a special merchant account set up just, for testing purposes. Request 
your SPI Evaluation Kit today. 



Software Piracy Intervention www.nwspi.com 
New Wave Software, Inc. 800-920-9283 info@nwspi.com 

Copyright© 1999 New Wave Software, Inc. All flights Reserved. Pat Pend SPI is a trademark ol New Wave Software. Inc. 

CybflrCash is a trademark of CyterCash, Inc, Authorise Net is a trademark of Authorize Net Corporation 






Visual Line of Sight 



Vis tied U n e oj ’ Sig h t D tag m m , 


Radio line of sighl takes into account the shape of 
the zone that the radio waves travel in. This is called 
the “Freznel” zone. Basically, the radio waves travel 
between the antennas covering an area that is shaped 
long an elongated football. (See Radio Line of Sight 
diagram). In other words, the clearance that you need 
hallway tel ween the antennas is greater than right at 
each antennae. In many cases, this means that you are 
at an advantage if one of the antennae locations is at a 
higher elevation than the other. 
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Radio Line of Sight Diagram. 

if you are doing a very short distance point to 
point setup, you have a lot of things running in your 
favor. There’s not as much distance, therefore 
opportunity, for things to get in your way. Your signal 
strength is higher because the signal doesn’t have to go 
very far. And, it's very easy to align the signal In the 
case of our Internet connection, this is exactly what we 


did — less than a 1/2 mile is all that we needed to 
cover. In fart, the signal even goes through the ho 
branches of a tree. del 

the 

Antennae Location, type and Cable Length al> 

One of the greatest challenges that we faced with 
our installations was the location of the antennas. Line LM 

of sight is an obvious contributing factor, hut the one evt 


made sense to me and l never even bothered to 
the docs for this Windows app. 

One of the nice features to WaveMANAGER i 
graphical feedback that you get to use when alij 
antennas. This is one of the strengths that the Li 
package has over the Aironei package (which u 
Lei net interface). 

AironeCs telnet interface does allow yo 
configure without using Windows. And, while tha 
plus, I like Lucent’$ GUI approac h belter and i( 
much easier to understand and configure. 




Remote Link Test in WaveMANAGER. 


One of the interesting things that happened 
we were aligning the antennas is that once the 
antennae was set up, 1 realized that it sends a 
strong signal in a pretty wide spread. Th 
combination with the Lucent PC Card’s sens 
(listening ability) made it such that 1/2 mile av 
had good signal (about 40% SNR) using the PC 
alone before we hooked up the second antennae 
WaveMANAGER considers SNR levels higher tha 
to be “Good*. In speaking to the experts, their ft 
again, was that "more is always better”. That said, 
they reach the 60-70% SNR levels, they don’t really 
get anything more out of it as that is quite good. 
You may wonder whai tricks you use to ali; 
antennae. Actually, it’s pretty basic... you use 
eyes in conjunction with how the Link Test perl 
You’ll find that certain tilings may cause imerfer 
In our case, we found dial when we moved 5-1 
away from a chimney, we gained about 10% 
because the top of the chimney has a metal fla 
causing interference. 
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SPr tracks down software pirates 
with every illegal click. 

SPI adds a protective layer to your program that allows only those end-users who legitimate¬ 
ly purchase your software to install it. No matter how many copies of your program get 
distributed illegally, only the valid purchaser can install and run your product. 

For just pennies a copy, you can protect all your products and significantly 
increase your revenue without increasing production costs. 

Features: 

- Win95, Win98, WinSOOO, WinNT, Mac/PowerMac 4 Resource Encryption 
’ Key File Encryption - 3 Built-in Demo Modes - Built-in Online Registration 
* Built-in General Purpose Registers 4 Distribute via CD/DVD, Diskette, Internet 

Sell your software without 
a shopping cart. 


SPI doesn't require expensive hardware keys or dongles to protect your software. Besides, 
you can’t download a dongle. SPI uses an encrypted software lock to protect 
installed files. Once a legal product is installed, SPFs T/xdt Point feature prevents 
illegal copies from running on any other computer, while SPFs uninstall feature 
allows end-users to move a protected product to another computer. Simply run 
the installer again and SPI disables the first installation, allowing the software 
to be installed on another computer. 


See for yourself how SPI 
protects your products. 


Visit our web site at www,nwspi.com to request our SPI Evaluation Kit. The SPI 

Evaluation Kit will allow you to protect one of your software products for 
up to one month. Each Evaluation Kit comes complete with the cross-platform 
SPI software, APIs and the SPI Users Guide outlining all of SPFs features. 
You can test every feature of SPI, including the built-in e-Commerce feature 
with a special merchant account set up just for testing purposes. Request 
your SPI Evaluation Kit today. 


SPI 


Software Piracy Intervention www.nwspi. com 
New Wave Software, Inc. 800-920-9283 info@nwspi.com 

Copyright © 1999 New Wdtve Sofluwe, Inc All Rights Reserved Pal- Pend. SPI is a trademark nf Hew Wave Software, Inc, 
CyborCasli is a trademark ol CyteiCssh. Inc Au1hqrizH.Net is a trademark of AnthnriM.Nal Corporation. 


No special hardware required. 


With SPI s built-in e-Commetce feature, distribute and sell your software in one easy step. 

Your customers simply download your SPI protected product and select Purchase 
when they run the installer. After entering their credit card information, SPI uses 
identity authentication, packet encryption and a secure link between SPI and the 
authorizing agent, to protect the transaction. Upon authorization, your product is 
installed and ready to run. You can even set up a "try-before-you-buy'' demo that 
can then be upgraded using SPFs e-Commerce feature when the demo expires. 


Features: 

* Real-Time Authorization thru CyberGash™ or Authorize,Net™ 4 No Web Store 
Front Required 4 3-tier Transaction Protection 4 Upgrade Demos to Full Version 
from Original Product Installer Download * Purchasc/Tracking Reports Provide 
Additional Credit Card Charge-Back Protection 4 Reduces Web Hosting Charges 
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Visual Line of Sight Diagram > 


Radio line* of sight Lakes into account die shape of 
the zone that die radio waves travel in. This is called 
die “Freznel* 1 zone. Basically, the radio waves travel 
between the antennas covering an area dial is shaped 
long an elongated football (See Radio Line of Sight 
diagram). In other words, the clearance that you need 
halfway between die antennas is greater than right at 
each antennae, in many eases, this means that you are 
at an advantage if one of the antennae locations is at a 
higher elevation than the other. 


Radio Line uf Si 12 hi 



Radio Line of Sight Diagram. 


If you are doing a very short distance point to 
point setup, you have a lot of things running in your 
favor. There’s not as much distance, therefore 
Opportunity, for things to get in your way. Your signal 
strength is higher because the signal doesn’t have to go 
very far. And, ids very easy to align the signal. In the 
case of our Internet connection, this is exactly what we 
did — less than a 1/2 mile is all that we needed to 
cover. In fact, the signal even goes through the 
branches of a tree. 

Antennae Location, Type and Cable Length 

One of die greatest challenges that we faced with 
our installations was the location of the antennas, Line 
of sight is art obvious contributing factor, but the one 


you may not he expecting is how close the antennae 
needs to be to your wired network. Typically, you want 
the length of the antennae cable to be 100 feet or less 
to the bridge hardware (the entry point to your wired 
network). 100 feet may sound like a lot, but it’s not. 

Antennas come in many shapes and gains (antenna 
gain is a measure of signal strength). The two that we 
looked at were die 14 dBi Yagi Directional and the 24 
dBi Parabolic Directional antennas. Essentially, these 
numbers represent antenna gain. In addition, the Yagi 
and Parabolic have different characteristics. For 
example, the Yagi has a beam focus of 30 degrees. In 
other words, when aiming the antennae, the signal you 
are sending has a spread of 30+ degrees (IS to each 
tile left and right, and up and down of the center point 
of the antennae). By contrast, the Parabolic antennae is 
more Focused with only a 7 degree (total) spread. 



Vagi. 



Parabolic Antcwuie 


When you are figuring out the type of equipment, the 
bottom line is that more signal is lvtter... always. To 
determine the amount of signal that you’ll have, you lake 
the antennae signal strength (e.g.. I t dBi for the Yagi 
above), and then subtract out the cable and connector loss. 

The cable ihai you will want to use is either 
LMR4D0 (good) or LMR600 (even better), in short, 
every foot of cable represents signal loss. For LMR40G, 
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there’s 7 dBi of loss per 100 feet. For LMR600, it’s 4.1 
dBi loss per 100 feet. Each connector is J dBi of loss 
— in other words, a cable with a connector at each 
end would have 2 dBi of loss plus the loss from the 
length of cable. By the way, these cables typically use 
something called an “N-connector". they are not the 
type of ihing rhat you would want to try and do 
yourself — so if you are considering cutting the cable 
and putting a new connector, forget it. This is not like 
1 OB ASET or ThinNer cables. Proper connections 
require soldering and skill. 

In our example here, let's say that we have a 14 
dBi Vagi and 100 feet of LMR 400. This means that well 
have 14 dBi minus 7 dBi for the cable minus 2 dBi for 
the connectors for a total of 5 dBi. This is not a lot, and 
we would be better off to use a Parabolic antennae 
here for decent connection. 

Mounting Logistics 

By far, for me, the hardest part about putting in a 
wireless network is figuring out the mounting logistics. 
Technically, these things are easy, but it’s easy to suck 
up hours looking for the right mounting bracket, 
fishing a wire through something, etc... 

If you listen to one piece of advice in this article, 
assemble your complete wireless network on a table 
indoors first before climbing up on the roof. Make sure 
that you can make all the' connections easily and that 
you have all the pieces and tools you need. 

WaveLAN Management 

Lucent's WaveLAN Point to Point bridge is managed 
using a piece of Windows software. At first, this might 
bother you, but in reality, you'll almost never have Lo 
touch this piece of software once you are installed. 
Don't let it bother you, just throw a copy of VirtualPC 
from Cnnnectix <http://www.C0nnectix.com/> on your 
machine and leave it at that. 

A couple of features to take advantage of in 
VirtualPC, First, let it share your Mac's IP configuration. 
It will save you die nightmare of configuring an IP 
connection under windows. Second, test this 
connection using a web browser — just to eliminate 
any unfamiliarity with Windows that you might have. 
Lastly, you can quit from VirtualPC without shutting 
down windows. VirtualPC can save the “state” that ifs 
in, so lhai you don't have to repeatedly wait through a 
Windows 98 boot time. 

Aside from one minor bug, I found the 
WaveMANAGER software to be intuitive and very easy 
to use. And the one bug was not that big a deal... once 
1 realized It, In the version, we used for testing, 
entering in the wrong password for the bridge can an 
erroneous Timeout" error. 
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Do you... 

□ read MacTech cover-to-cover each month, 
eager to learn the latest Mac technologies? 


V 


Do you... 

□ want to use your skills to serve the Bibleless 
peoples of the world? 


Do you... 

□ want to live and work in an attractive location 
close to two Canadian national parks? 


Wycliffe Bible Translators is developing cutting-edge MacOS 
applications for linguistic research in the worlds minority languages. 
These tools will be used by expert linguists working in remote 
locations in developing countries to help local Christians translate the 
Bible into their own language—the language of the heart. 

Wycliffe does not pay a salary Instead, individuals arc sponsored 
financially and prayerfully by churches and friends that want to have a 
part in the work of Bible translation. 

If you believe Clod could be calling you to join our team, please 
contact us: 


Macintosh Deveiopment Unit MeiLMayhe w@ wycliffe.org 

Wyc I iffe Bi b le Tra ns I ators w w w. wyd i ffe.org 

4316“ 10 St. NE, Calgary, ABT2E6K3, Canada 1-80Q-463M143 



Timeout Error in WauaMANAGER. 


Of course, once J figured this out, it was no big 
deal. Aside from this, ! liked the application — it just 
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made sense to me and I never even bothered to read 
the does for this Windows app. 

One of the nice features to WaveMANAGER is the 
graphical feedback that you get to use when aligning 
antennas. This is one of the strengths that the Lucent 
package has over the Aironet package (which uses a 
telnet interface). 

Aironet’s telnet interface does allow you to 
configure without using Windows, And, while that is a 
plus, I like Lucent's GUI approach better and it was 
much easier to understand and configure. 



Remote Link Test in WaveMANAGER. 

One of the interesting things that happened when 
we were aligning the antennas is that once the first 
antennae was set up, I realized that it sends a pretty 
strong signal in a pretty wide spread. Thai in 
combination with the Lucent PC Card's sensitivity 
(listening ability) made it such that 1/2 mile away, 1 
had good signal (about 40% SNR) using the PC Card 
alone before we hooked up the second antennae. 

WaveMANAGER considers SNK levels higher than 20% 
to be “Good”. In speaking to the experts, their feeling, 
again, was that “more is always better”. That said, once 
they reach the 60-70% SNR levels, they don’t really try to 
get anything more out of it as that is quite good. 

You may wonder what tricks you use to align an 
antennae. Actually, it's pretty basic,., you use your 
eyes in conjunction with how the Link Test performs. 
You’ll find that certain things may cause interference. 
In our case, we found that when we moved 5-10 feet 
away from a chimney, we gained about 10% SNR 
because the Lop of Lhe chimney has a metal flashing 
causing interference. 


Remember, higher speed connections, longer 
distances, and interference require better signal 
strength to get the job done. This is where your choice 
of higher gain antennas, shorter cable lengths, better 
quality cable, etc. ...all come into play. 

Water-., the enemy 

The folks at Winncom Technologies tell me that 
the number one enemy to your wireless signal is 
actually water. Its not a matter of if, but when you are 
going to get water into the connections... unless you 
take the right precautions. Water will seriously degrade 
you r co n neetion. 

To prevent water from being a problem, wrap the 
connection neatly with everyday electrical tape. The 
tape should extend from the insulation before the 
connector to the insulation beyond the other connector. 
In other words, you should completely cover the 
connection and the connectors with the tape. Then, 
cover all of the electrical tape with outdoor grade silicon 
(e.g., GE’s Silicon II). If the cable is going to be lying on 
a roof, make sure that the connector has a block 
underneath it to keep it out of the water. 

Conclusion 

Bluntly, wireless is just plain cool. Thanks to 802,11 
and Apple, the wireless market has become very 
competitively priced. Competitive here means it that it 
competes with wired and wireless solutions. 

Personally, I like connections that if there’s a problem, 
I can walk up to ir myself and fix. Wireless is that way - 
ii T s all within your control, not that of a TelCo. 

1 love the fact that these things are blazing fast, and 
hassle free — oh yeah, and there's no monthly fee! 

The Lucent product is simply an excellent product, 
well thought out and versatile. 1 like the Aironet product 
as well. If you are Interested in wireless, contact a 
distributor like Winncom, and figure out which of the 
products fits your needs best... as each situation is 
different. But, don't be afraid of wireless. IPs just too 
cool... and practical... to pass up. 

Many thanks to the following who helped with the 
research of this article; Steve Wozniah (who turned 
me on to wireless to begin with), Marty 
Staudenmaier and Mark Shapiro from Lucent , 
Mike Maty and Gregory Raskin at Winncom 
Technologies (who all educated me a hunch on 
wireless); and Justin Newton, Director of Networks at 
Net Zero (who helped me play with everything <g>). 
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"LaiiO's depth and power arc as founding, * 
"Lasso's strengths are- its defensive 
buih-in commerce end e-nmi features. 

MacWhtK 


"With excellent support for advanced 
FileMaker Fro features, ourstaiicAng 
formatting control, fast performance, 
and iborough docurTwntefion, Lasso 
is a UaLaba^pubfrshirig diman." 

Macwodd Magazine 
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Web Data Engine 
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New 3.5 
Version! 
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“Lasso has proven to big a great resource 
for the Mac 05 Software & Hardware 
Gwrde We are very impressed with the 
speed of the searches m a database of 
this size, 'four company support has 
been greot toof “ 

Gayio WbstbrcvoA; 

Software A Hardware Guide 
Product Manager at 
Apple Computer 


"Lasso sunpiy btews Tango out of the water " 
Paul Marty 
Umversity of Illinois 


Lasso 3.5 Web Data 
Engine.. Leads The Way. 

Building custom and shrink-wrapped database-driven Web applications requires a whole new way 
of doing things. Having pioneered the Web Data Engine™ over three years ago. Blue World and 
the Lasso Web Data Engine consistently lead the way providing a feature set Web developers 
describe as "incredible/' Build online stores, discussion forums, resource management systems and 
other demanding data base-driven Web applications with unrivaled performance, ease, security, 
extensibility, control and flexibility. Develop using multiple languages—including LDML, CDML, 
Server-Side JavaScript, Java and XML— and deploy across multiple platforms. Your Lasso code 
works identically regardless to which database you're connected. Lasso-powered FileMaker® Pro 
Web databases easily scale to big iron ODBC-compliant databases like Oracle, Informix, Sybase 
and more with little or no change. What's more, the Lasso Java Application Programming Interface 
fl_I API) provides developers an easy-to-use Java-based API for unprecedented extensibility. 

Find out why hundreds of thousands of websites rely on award-winning Lasso technology for their 
business critical Web data. Download a 30-day evaluation copy at www.blueworld.com/download/ 
or order securely online today at the Blue World Store at store.blueworld.com. 

Lasso 3.5 Web Data Engine - The leading Web Application Server for Macintosh and beyond. 
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IN THE PALM OF 
YOUR HAND 


by Marshall Clow 


PalmSource ‘99 


Report from the Palm Developers r 
Conference 

Introduction 

PalmSource *99 taka the Palm Developers' 
Conference) was held in the Santa Clara Convention 
Center on October 19-22. 1999. It was attended by over 
2000 developers, almost twice as many as last year. 

Tile opening keynote was given by Eric Renhamou, 
CEO of 3Com. He introduced the catch-phrase for the 
e n 11 re con fere nee , the “Palm Ec< >nomy", re ft: rr I n g to a 11 the 
people 1 involved in creating, selling, buying and using 
Palm Platform devices Me claimed that there were over 3 
million users of Palm devices, and tltai there were over 
4000 software titles available for the platform. 

You can't tell the players without a scorecard, and this 
was certainly true at PalmSource. Palm Computing, Inc 
(which will lie spun out of 3Com early next year in an 
IPO), has several groups, all pulling in different directions. 
It is made up of three divisions: 

* Palm Platform 

This is lire group that licenses PalmOS and hardware 
designs, They work with licensees such as IBM, Symbol 
Handspring, TRG, and so on. The OS development 
happens here, tfx>. 

* Palm Devices 

This group designs, builds, and sells the Palm branded 
hardware, such as the Palm 111, Palm V, and Palm VII. 

* Palni.net 

This group selIs/manages/develops the data services 
used by the Palm VII (and no doubt soon, other 
w i re] ess d ev ices), 


News 

The big news of the conference was that Nokia and 
Palm announced an agreement to implement the PalmOS 
on the kernel that runs in Nokia cellular phones. Since 
these phones use the A KM chip instead ol the 1 )i agon ball 
processor that is in current PalmOS devices, this will rake 
them a while (think of Apple and the move to Lhe 
PowerPC). On the other hand, there are millions of Nokia- 
based cell phones out in the field, and there are thousands 
more sold every day. 

Alan Kessler, president of Palm Computing, laid out a 
r< xu 1 1 mi p of the f u u i re of Pain i< JS, He t; \ I k ed a I xn it th i ngs 
that Palm will be doing (in the next year or two): 

• Hardware Abstraction for the OS (esp for ARM 
processor) 

• Produce Reference Hardware Designs 

These reference designs will lx* * licensed to Palm 
Platform developers that want to create Palm 
c < >m pa t i bl e h a rcI w a re. 

• Produce models with differing screen sixes 

Right now, all Palm Platform devices have the same 
screen size, 160 x U>0 pixels. In the future Palm (and their 
licensees) will he producing devices with larger and 
smaller screen sizes. 

• Better audio 

• Maintain compatibility with current devices 

• Belter modularity for the OS (less interdependence 
between modules) 

Development* Info 
PalmOS 3-5 framework 

If you signed an NDA at the conference, you could 
take home a CD with a bunch of development info about 


Marshall Clow is a pnjgrymmcr. He has worked for Pabmar Software, IIP, and Aladdin Systems. Among other things, he lm written PICT Detective, 
AfcHltlin's Kestmirc Compression Tcxtlkit, and way too many resentrcc-proccssing tools. He currently works tor Atlolte Systems, whoe his title is “Bad 
influence*. When he's not taxiing, he can he found mountain hiking with his kids or checking out micmhrewcrics. He can lie reached at 
<mck m @ma illinst 2.esuxm.edu> 
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the next major revision of PalmOS, allied PalmOS 3 A 
The new feature that generated the most excitement at the 
conference was support for color screens in 3A Since 
Lhere are no Palm-compatible devices out there with color 
screens, this is dearly an “important future direction" for 
the Palm Devices group. 

A lot of this information is available online at 
<http://www.palm.com/devzone/docs/palmos3S.html> and 
<http://www.pafm.com/devzone/pavilion.html> 

Poser 3*0 

Palm announced at the conference a major revision to 
its excellent debugging aid. POSE 3.0. POSE (or POSER, 
as it is sometimes called) stands for Palm OS Emulator, It 
is a program thal runs on Macs and PCs (and some 
Unixcs) that emulates a Palm OS device. Since POSER 
runs on the host anti can interact with your development 
system, this makes debugging much easier. You can 
debug your program in POSER, using the source-level 
debugger that comes with Code Warrior 

C<k!cW arrior r6 

Oh yes, CotleWamur. Metrowerks and Palm announced 
that CodeWunlor r6 for PalmOS shipped the first day of the 
conference. This is the same Code'Warrior that mac 
developers use every day. The same IDE* the same 
debugger, and so on. It does come with a different linker 
and resource compiler to generate PalmOS-sfiecilic binaries. 


Palm Application Framework 

Palm announced that they would be learning up 
with Bear River Associates to produce the Palm 
Application Framework. This is a C++ application 
framework tor writing PalmOS applications, similar in 
principle to MacApp or PowerPlant on the Mac or MFC 
on Windows, The framework will be released under an 
Open Source license. 

To find out more, you can send email to 
<paf_info@bearriver.com>. 

Other sessions 

There were also sessions on debugging, memory 
management, conduits (many, many sessions on conduits) 
flow to write apps for the Palm VII. development tools, 
and much, much more. 

Summary 

PalmSource 99 was a great deal for anyone wanting 
to start or continue a business programming for PalmOS 
computers. It was a rescinding success, with over twice as 
many attendees as last year, and a great way to get to meet 
the people developing the Palm 08. 

If you couldn't make it to PalmSource *99, check out 
<http://www.palmxom/devzone/index.html>, where Palm is making 
much of die material from the conference available.. 

See you at PalmSource 2000! 
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in your language. 

Tools Plus Pro quickly 
turns your great ideas 
into great applications 
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Everything works as 
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a breeze to maintain. 
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TOOLS OF 
THE TRADE 


by Dill von Hagen 


ProVUE’s SiteWarrior 


Automating Web site 
management and 
standardizing content 


Huge web .sites can be a 
nightmare to maintain, both because 
of the sheer number of pages and 
because of the frequency with which 
page data and inter page relationships 
can change. Developments in 
browsers and Web technology such as 
SSI (Server-Side Includes), CSS 
(Cascading Style Sheets), and XSI. 
(extensible Stylesheet Language) go a 
long way towards helping the web¬ 
site designer standardize the visual 
identify of a site by imposing a single 
set of styles across a site. 
Unfortunately, imposing an analogous 
set of standards across the content of 
your pages can still be a difficult task. 

ProVUF/s SiteWarrior is a web site 
management and creation tool that takes 
a unique approach to page storage and 
content standardization. SiteWarrior 
stores web sites in an internal database 
where each record contains a single wcl) 
page, for storage and management tasks 
SiteWarrior uses ProVI IE's own market- 
tested Panorama RAM database, and 
therefore doesn’t require that you already 
have a database application on your 
system. Using a database often brings 
visions of shotguns Loaded with cryptic 
SQL commands to mind, which isn't the 
case at all with SiteWarrior. SiteWarrior 


uses its integrated database Ixrliind llie scenes to pixxiuce final 
versions of your web pages — you don't have to know a 
single tiling alx>ul databases in order to use SiteWarrior. 

Once you've created and stored web pages in 
SiteWarrior, you can either preview them with a browser 
or export them as separate HTML files, a process which 
SiteWarrior calls “rendering/ SiteWarrior helps enforce 
consistency guarantees in the pages you render by 
inserting standard headers and footers, standard server- 
side includes, and even automatically generating portions 
of tlie content for your pages. 

Getting Started with SiteWarrior 

Site Warrior’s installation process is as easy as you'd 
expect from any Mac application. One significant problem 
with the version l reviewed is that it did not create a 
SiteWarrior folder (as advertised in the documentation), 
but instead installed all of the SiteWarrior files and folder 
at the top level of the selected disk. If you arc 1 as 
meticulous as I am about using neatly nested folders for all 
of your software, you should create a SiteWarrior folder in 
your target install location before installation. 

After installing any Web software package, my initial 
inclination is to set a cup of coffee on top of the 
documentation, lire up the software, and starting hacking 
pages. Unless you Ye psychic, that isn’t possible with 
SiteWarrior. There is no SiteWarrior icon, which is an initial 
hint that you are indeed working with W r eb sites and pages 
in a whole new way, SiteWarrior provides a template web 
site in a folder called Empty Web Site. I n create a new web 
site in SiteWarrior, you have to duplicate this folder, 
renaming the copy to suit your site. You start SiteWarrior 
by opening this folder, renaming the file 
www.emptysite.com to match your site, and then you 
double-click on the renamed file. Frankly, a helpful little 
AppleScript to do all of the above would lie a win in my 
book, but it's always nic e to leave a few bells and whistles 
for the next release. 


Bill von Hagen is a writer, computer system administrator, and the author of "SGML for Dummies.” You can contact 
him at wvh@gethip.com, 
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Creating Pages with SiteWarrior 

Site Warrior's main screen is organized into three basic 
areas, with an attendant button bar and set of menus. (See 
Figure 1.) Once you have created pages, you can organize 
them into subsets in the Groups window, which simplifies 
maintaining different looks for different parts of your site. 
When you first start SiteWarrior, it provides two default 
entries, ALL and Main Similarly, the Pages area lists all of 
the pages that are available in die active web site, and only 
lists the default Home page when you first open a new site 
project. Tlie contents of the currently selected page arc 
displayed in the largest window, which is empty when you 
start a new SiteWarrior project. SiteWarrior s page editor is 
simple bur functional. If you are a BQEdit fan, you’re in 
luck — Site Warrior's Edit commands allow you to 
automatically open the current page in BBFdit, 
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Figure L Sample Home. 


To create a new page in SiteWarrior, select die Edit 
menu's New Page command. A dialog is displayed (See 
Figure 2.) in which you supply general information about the 
page, such as its name, title, meta tag keywords* and a 
general description of die intent of the page. You can also do 
this via die keylxxuxl shortcut Comma nd-N, which is exactly 
what you'd expect in a savvy Macintosh application. 



SiteWarrior is a text-oriented application, a fact that is 
heavily stressed in the documentation, For this reason, to 
add content or markup to a page means you must either 
manually enter pairs of HTML tags or dick icons on the 
button bar to insert the appropriate HTML lags. I can 
already hear WYSIWYG page design fans beginning to 
chant "Burn It! Burn ft!," hut I’d like to meet a web page 
designer who hasn't closed his or her office door and 
manually hacked a web page or two. 

SiteWarrior provides complete, integrated balloon 
help like any good Mac application. The balloon help is 
extremely useful when trying to figure out the meaning of 
the various icons on the button bar, Their meaning was 
intuitive in retrospect, after reading the associated 
balloons, but the balloon help was quite handy in solving 
tins classic bootstrapping problem without resorting to 
clicking buttons it) see what they actually do. 

Once you’ve added lags and content to a page, you can 
preview it at any time by selecting tile Render menus 
Preview Page command. This displays the current page in 
your default browser. 
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Figure 3, Page Preview. 


Working with Existing Sites and Pages 

Few people today have just one Web page design tool 
in their software tot tidiest. An important issue is how well 
Site Warrior lets you work with existing sites and pages. 
Site Warrior's File menu provides an Import Pages dialog 
that lets you browse for existing pages to import. 
SiteWarriors import command worked well, but still 
provides some opportunities for incremental 
improvement. For example, it would he handy to have the 
option to strip or correct extraneous characters during the 
import process. Similarly, it would be nice to l)c able to 
automatically verify links on imported pages during the 
import process. Idling you know if you've overlooked any 
files that you meant to import. Though you can 
subsequently verify links using the Site URL Maintenance 
command from SiteWarrior s Edit menu, a little automation 
here would lx: a nice thing. 
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Standardizing Site Content 

Standardizing SITE SitcWarrior's greatest strength is its 
ability to insert entries that will l>e replaced by blocks of 
HTML code when you render :i page. SiteWarrior does tliLs in 
two di fie rent ways. First, you can define Tug nicknames” for 
commonly-used terms or complex HTML expressions, and 
second, you can use SiteVPSarrior's “Supertigs", which 
automatically insert things like extra document header 
information, server-side includes, special types of generated 
content, and so on. When you render a page containing 
either tag nicknames or Supertags, they are automtilktilly 
expanded into the more complex infonmtion that they 
represent. Not only are these useful to provide simple 
shortcuts for complex expressions, but they help eliminate 
die standard “query-replace" problem when you need to 
change something that appears on multiple pages throughout 
your site. By coding items such as a product name as a 
Site Warrior’s tag nickname, you can change that object 
through every referenced page by simply modifying the value 
of the nickname. You can view or edit the list of available tag 
nicknames al any Lime by selecting die Tags menu s Tag 
Nicknames command 

Using SuperTags 

Site Warrior’s lag nicknames are a Limesaver, hut its 
SuperTags are a thing of beauty. Unlike tag nicknames, 
which simply substitute terms or HTML expressions 
during rendering, Supertags can either insert special 
content, such as standard page headings and the 
current date, or can generate complex content for the 
appropriate Supertag. ProVIT calls these Superrags 
“HTML factories" because of their ability to 
automatically generate content, insert styles, and 
otherwise help standardize your web site by freeing 
you from a significant amount of tedious, error prone 
work. You can even create custom templates for the 
HTML generaled from Supoi' 1 ags, providing you even 
more opportunities for customization. As an example 
of the power of SuperTags, let's examine the 
Super lags provided to help generate tables of contents 
and Iables themselves. 

Anyone who has maintained a large, dynamic web 
site and an associated table of contents page knows 
what a hassle it is to keep the table of contents up to 
date. As pages are added or removed from the she, 
updating the table of contents to reflect the current set 
of pages and their correct position in the site’s browse 
sequence can be time-consuming and is easily 
overlooked when frantically adding content. In 
Sire Warrior, you can automate tills entire process by 
inserting the tableofcontents Super lag. When the web 
site is rendered, the table of contents SupcrTag is 
automatically replaced by a generated table of contents 
for all of the pages in that site. The HTML elements that 
are compiled into Lhc table of contents are the contents 


of the TITLE tags for each of the site’s pages. The 
contents of the II I ML TITLE tag are entered in the Page 
menu's Page Options dialog, which you filled out when 
you created the page but can edit at any time. 

When creating longer pages, you often want Lo create 
a table of contents For a single page. SiteWarrior 
automates this process by providing a PageContents 
SupcrTag* The HTML elements to be compiled into a 
page's table of contents are identified by the use of 
anchor mgs. For example, the following tag would 
automatically appear in a page's table of eon tents after 
rendering a page containing the PageContents SuperTag: 

<A NAME^TTTLE>This ia a Page Table of Contents 
Em 1ry</A> 

Separate SuperTags for site-wide and per-page 
tables of contents cover the most common cases where 
you would otherwise have to manually create tables of 
contents. You can also use the tableofcontents SuperTag 
to automatically generate tables of contents for subsets 
of the pages, by using the tableofcontents SuperTag’s 
GROUP attribute. As mentioned earlier in this review, 
SiteWarrior lets you associate different pages with each 
other by assigning them to SiteWarrior page groups. 
When you insert a tableofcontents SuperTag whose 
GROUP attribute is set to the mime of that page group, 


GOT BUGS? 

...and you’re drowning in paper 
trying to keep track of them? 

You need BugLink! 

■ BugLink is a client/server application allowing you 
to connect developers, testers, and support engineers 
anywhere in the world. 

* Intuitive user interface gives you the information you 
need at a glance. 

* Fully customizable database— add the fields you need 
to each project. 

* Custom TCP/IP protocol minimizes network 

traffic— ideal for dial-up connections, 

■ Client applications can operate 'off-line’— allowing 
bug entry and modification even when not connected to 
the network! 

* Cross platform— set up mixed Macintosh and Windows 
environments in minutes with no additional software 

needed! 

* Try before you buy* Download and try risk free for 
30 days from http://www.pandawave.com/bl/ 

A 5 User License starts at $299; thaL's only $60 per person* 
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The products you need, with the prices 
and service you deserve... guaranteed. 




CodeWarnor Professional 5 put everything you need for software 
development at your Fingertips; project management tools, text and 
resource editors, source and doss browsers, compilers, linkers, 
assemblers, and debugger Release 5 offers such Features as RAD for 
Java, foster compile times, focal and remote application debugging, 
IDE extensibility options and even tighter C/C++ compliance. 
Additionally, you can create applications For Windows 95/98/NT and 
Mae OS 8.x and Mac OS X from either host platform, (available in 
versions hosted on Mac or Windows) 


Rescrcarer is the only supported genord-purpose resource editor for 
Macintosh. Relied upon by thousands of Mac developers, Resoraerer 
features a wedth of powerful yet easy-to-use tools For easier, foster, and 
safer editing of Macintosh data fifes and resources. Whether you hove to 
parse a picture, debug a data fork, design and try out Bdbon Help, 
create o scripting dictionary, create anti-alfosed toons, design and edit a 
custom resource with 40,000 fields in it, create C source code to run a 
dialog, at any of hundreds of oilier resource-related tusks, Resorceter's 
magic will quickly save you lime end money. 


VOODOO Server is a version control system for software developers 
using Meteuwerks CodeWamor under Mac OS VOODOO Server and 
the corresponding VOODOO clients (the irvduded CadeWamar VCS 
plug in and the VOODOO Admin application) are designed to offer 
reliable and robust version control features while minimizing the 
administrative overhead that usually accompanies version control, if 
you're a singfo programmer or managing a team of developers, version 
control can moke or break your project. Do it right, with VOODOO! 


C++ Developer's Kit StQndars was developed for everyone who, even 
without much knowledge of C++ language or software developing, 
wants to know the C++ programming language with applications in 
the OOSE. C++ Developer's Kit explain* software solutions for C++ 
developers, programmers and C++ students. 


BugLink Solo is a database dedicated to collecting and tracking 
problem reports. Ideal for the shareware developer. BugLink SoJo allows 
you to distribute wife your software BugLink Reporter, which can easily 
be configured to allow your end users to send structured bug reports 
directly to RugLink Solo Promt users for exactly fee information you 
need, send immidtate report conformations, customize a new database 
to each project, search For related bugs with a simple query. To kill bugs 
dead, you have to know where to Find (hem 


Almost 2000 articles From over 150 issues of MncTcch Magazine 
All fee tutorials, technologies, and reviews from 15 years of 
Macintosh programmers in the easy to access THINK Reference, 
personal database formal Also includes fee entire run of Apple's 
develop technical journal, fee Inside Macintosh reference manuals, 
the FrameWorks archives, and more. This release Features the 
THINK Reference compiler, allowing you to create your own THINK 
Reference archives from HTML! 
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WebSTAR Server Suite it & compteta sol of powerful and easy-to-u 
INtemet servers far the Mac 05 Effortlessly serve web pages, liosl ern 
accounts, publish databases, and share flies — aft with a sine 
application on one Mac I WobSTAR Server Suite is perfect fer Internet 
Intranet serving, single or multiple sites, smalll and large businesses 
' power arid ease of use suv^s any organization time and money 


Award-winning Freeway 2.0 is simply the fastest and easiest way to 
create web pages ft-ofessional web designers worldwide use Freeway 
with its support fer CSS and HTML AO, along wife auto image slicing, 
image optimization, multilingual spell-checking, HTML Import, built-in 
FTP, and an exciting new Adkxis technology to emote and maintain 
feoding-edge websites — all without coding a single line Tree-way ships 
with a 390page manual [5/5 Computer Arts Magazine), Fitemaker 
tutorial, c PhotaOisc offer with free imoges and morel 


freeway 

2.0 


Ideal for marketing departments targeting their advertising dollars. Funnel Web allows you to identify the origin of each client, last site visited and the keywords and 
search engines used to locale your site on the Internet. Funnel Web also offers multilingual support providing reports in over 12 different languages W® have also 
introduced post process archiving of log fifes using using Aladdin Systems' Stuffit Engine (Mac), ZIP (Windows) and Gzip compression In addition, it is also possible lo 
automate the upload and download of bg files to remote sites using FTP. Built in email notification olso provides completion reports after each process 


Any serious gamer knows the superiority of the flight joystick. Until now, 
Mac users have been hard pressed to find a gaming joystick with the kick 
butt power and res i fiance they need. The MacSurfer USB JoyStick fits that 
gap with features like 4 trigger buttons, rapid fire Finger trigger, hat 
control, throllfe, two way self centering, and complete customization for 
your game with the included Overdrive software. 


Gel your Power Book connected to Apple 's AirPorl with the 
Faratbn SltyUNE PCMCIA card or just create on ad-hoc network 
between two Or more portable computers for file sharing. 
SkyLINE's robust Control Panel provides 


a real-time signal 
strength meter (Macintosh version), network statistics, as wdl as 
dynamic configuration without needing to reboot! 


$268.95 
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you can automatically generate a table of contents for 
a specific page group during rendering. 


Automatically Merging External Information 

Site Warrior provides several SuperTags to help you 
automatically include, import, and formal external 
information. The Include, Merge, Mergelmport. and 
Tablelmport SuperTags automate different ways of 
integrating external data, templates, and other 
information. Let's look at Site Warrior's Tablelmport 
SuperTag to see exactly how these types of tags can save 
you time and prevent the errors that are often accidentally 
introduced when you update complex pages, 

A similarly tedious task to maintaining tables of 
contents is maintaining HTML tables, especially when 
done manually. This is painfully true when the source 
of the table data is in an external database dial can be 
changed independently. Site Warrior's Tablelmport 
SuperTag lets you store table data outside your web 
pages, thereby automating this process. Ii 
automatically imports and generates tables from that 
data during the rendering process. 
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Figure 4. Tables Import 


The Tablelmport SuperTag's FILE attribute identifies 
the name of the file with delimited entries that make 
up each row of your table. Whenever you need to 
update the tables in your site, you simply use your 
database application to generate the delimited file and 
then re-render the site in Site Warrior. The next figure 
shows the HTML table produced by this rendered 
Tablelmport SuperTag. 



Figure % Tables. 


In addition ro rlie KILE attribute, the Tablelmport tag 
provides a number of other attributes that make it easy to 
generate sophisticated tables. The COLUMN attribute lets 
you specify column titles, specific column widths, column 
alignment, and the background color for any column. A 
COLOR attribute lets you automatically specify separate 
table background colors, and an associated 
COLORPATTERN attribute lets you define a repeating 
pattern of different row colors, The Tablelmport SuperTag 
also provides other attributes that let you further 
customize the layout of rows, columns, an entire table, or 
the cells in a table by providing HTML templates. 

Conclusion 

Site Warrior is a powerful web sire creation and 
management tool. Web site designers with a more graphical 
focus will need to augment Site Warrior with a graphical 
page design tool, but once you've settled on a look for your 
site, it’s easy to make rl inlo a Site Warrior template for future 
pages. If your focus is more on content and site design as a 
programming task, you will quickly fall in love with 
Site Warriors tag nicknames, Supertags, and similar shortcuts 
for automatic generation of content and standardization of 
Llie pages in your web sites* All in all, Site Warrior is a 
powerful, capable tool for Web page design and 
management. If you can overcome its non-WYSIWYG 
orientation, Site Warrior is a powerful addition to your web 
site war chest. EEO 


Interested in writing 
for MacTecb ? 
Download the writer’s 
kit from 

www.mactech.com 
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WEBTECH™ 


by David K, Every 


Introduction to WebObjects 


What does WebObjects do? 


What is WebObjects? 

Man) people don't understand what 
WebObjects is, where it Ills in Apple's 
sirategem, what a web-application is, and 
vvliai WebObjects t an do for them. The 
purpose of this article is to answer those 
questions and a few more along the way, 

WebObjects Ls a superior environment 
for creating and deploying high end web 
applications. In short, WebObjects is an 
enterprise web application server. 
I fowever, that begs other questions; ‘ What 
is enterprise?", “Wku is an upphcaiion 
server?", ‘How does this fit into a large 
scale muili-hered client-server solution?" 
and of course, “What does it all mean?" 
Have patience and Ml try to get to it all. 


Enterprise 

When I defined WehObjeeis. I said 
"enterprise" web application server — 
and Apple uses the term "enterprise' as 
well — so what is “enterprise"? 
Whenever 1 want to know what a word 
means. 1 hit die dictionary: 

Enterprise - en*ter*prise (en- 
tor-prize) re An undertaking, 
especially one of some scope, 
complication, and risk. 

A business organization. 

Industrious, systematic activity, 
especially when directed toward 
profit. 

Willingness to undertake new 
ventures; initiative. 


WcKlbjects, along withQxoa and EOF, are Apples Enterprise 
Solutions — and that definition explains wiiai these products are for. 
if you need to create a prtxluct of any complication (large scope) 
that has some risk, then WdiOhjccts helps. It requires a little 
initiative and willingness to take on a new venture, but then all 
business is based on that, it is designed for serious business 
organize tioas — and making a profit off of the web. 

WebObjects, Cocoa and EOF are what I call the divine 
trinity of enterprise development: three tools, all related, that 
all empower each other, and are even aspects of each other. 
All three frameworks / tools are powerful solutions on their 
own — but they are complementary and can work together 
to form a complete solution. 

The WebObjects Framework and Cocoa (formerly known as 
Yellow Box, OpenStep, or NeXT STEP) share some functionality, 
and many of the same classes, including their foundation 
framework. They are the evolution of the NeXT Step Framework, 
that is very rich and mature (10 years for Cocoa and 5 years for 
WebObjects). 'Iheir primary difference is the type of applications 
they target. Cocoa targets stand alone user interfaces (client-side 
binary applications) while WcbObjeris targets wvl>applications; 
applications that are deployed across a network, and run in 
either a web browser (HTML) or a Java runtime. 

EOF (IjHerpn.se Objects Framework) is a specialized solution 
that comes bundled with and can lx* used with either Cocoa or 
Wei >OI )jccns. HOF is an abstraction layer that uses modem OOD/P 
(Object Oriented Design and Programming) techniques to 
interface with data (usually traditional Lable/mw/eolumn type 
procedural relational database management systems RDBMS), 
other systems (security, commerce, or MRP systems) and 
legacy programs (like mainframe client-server applications). 
EOF allows the creation of database schemas, and wiring 
them together in a visual fashion, and hides almost all of die 
complexity of working will) databases (concurrency issues, 
caching, uniquing, and so on) from die implementors. EOF 
is also an excellent abstraction layer on top of any data 
store. Its basically a way of managing data piped to/from 
any outside source. 


David K, Every is a Senior Software Engineer who has done many client-server solutions, a WebObjects programmer, and the 
creator of the MacKiDo website (http^/www,MacKiDo.com). You can reach him at dke@niaekido.com. 
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There is a lot of hype of kite about KJR. Enterprise 
Java Beans is a concept whose time will come — but is 
not completely ready for prime time yet,. As Enterprise 
Java Beans matures, it should fit in quite complimentary 
with some other parts of WebObjeers — there Is less 
overlap than one might guess aL first glance. 

Most web applications are client-server solutions 
where the user is the client (using a web browser) who 
accesses the web application server to do certain actions. 
The most common anions arc things like tracking what a 
user wants to buy (via shopping carts), or remotely 
accessing database information that is stored on the 
server. Since most of these solutions are dealing with 
databases, EOF is crucial to most We bob jeers solutions. 
Many Cocoa applications also work with database and 
legacy systems. In the future, more and more client-server 
type Applications (solutions) are going to migrate to wider 
network possibilities (the Internet) and therefore make 
use of web-centric interface (WebObjects). So neither 
Cocoa nor WebOhjeeis needs EOF — but it just makes 
them both more useful. 

So your interface and target market will help dictate 
which of these tools you choose; Cocoa is great for 
making stand alone applications that can lie client-server 
solutions (using EOF). Cocoa makes it easier to develop, 
maintain and deploy these apps than traditional Mac 
Applications. If you want to create similarly easy to 
develop, maintain and deploy versions of Web-based 
solutions, or if you desire your application's interface to 
be a web browser (html) or Java, then WebObjects is the 
way to go. EOF is used by both to integrate database 
solution into your solution. And the Foundation 
Framework layer is common in all of them and is the glue 
that binds them together. 

Application Server 

To understand WebObjects, it helps if you 
understand the basics of how the Internet (Web Servers 
and Web Clients) works. The very high level view is 
that you have a server that has a domain name and an 
IP address. You type in the URL (domain and path 
information) or click on a link, which gets directed to 
that server. The server sees that as a request, and it 
responds by sending a file that a web-browser can 
understand, parse, and display. 

This request-response cycle is the whole conceptual 
foundation of the HTTP (Hyper Text Transfer Protocol) 
and the work) wide web. Users request something by 
typing the URL, choosing a favorite, clicking on a link 
or image, and the server responds. 

Normally the web servers just respond with static 
files (unchanging text and pictures to present 
information) that are web pages. Sometimes websites 
want to do more than just serve static pages — and that 
is where application servers (like WebObjects) come in. 


Application servers are far more versatile, they 
typically don’t just serve s La Lie pages and images. The 
"pages" that an application server serves contain links and 
form elements that the client can manipulate to do more 
than request static files. These links can pass information 
to the serv er and l_hus control applications running on the 
server Such applications running on the server can do a 
number of things which are belter suited for the server 
than the client, such as performing a database query, or 
crunching compute intensive calculations, or taking 
information from the client and adding it to a database on 
the server based on form submission or by remembering 
previous .selections and behaviors. Basically a web 
application allows a website to do anything that an normal 
client-side application can do, with the only limitation 
being that the user interface is what you can pass and 
return from a web browser* 

Traditional web serving could be described as 
providing access to books (of many pages) on-line and 
letting the user turn the page, or choose other related 
topics. You can extend this static functionality with 
dynamic capabilities and animation using DHTML, 
Flash, QuickTime and JavaScript. For the most pan 
these extension typically just provide you with a more 
eye-catching book — they don't fully utilize the 
potential provided by the interconnectedness of this 
new medium (the web). 

Putting static links on a page also requires a lot of 
forethought The web designer has to know a priori what 
the user might want to do at every step, and then add 
links representing a limited set of options to choose from. 
This is not unlike the menuing systems of old — a fairly 
low brow interface — the user points at one choice 
among a few and grunts, implying “that one*. The user 
then gets to make another choice among a few and so on. 
This is not the highest form of communication. 

Application serving allows for many, many more 
possibilities, and allows the user to offer real input. 
With applicator! servers, users can ask very complex 
things, submit larger amounts of information (to be 
processed) and allow for far more growth over time. 
The simplest form of an application server is having a 
search tool (application) for a site — then at least the 
user experience is growing a little beyond point and 
griml — however, application servers arc usually much 
more sophisticated than dial. Instead of serving static 
pages (the same pages to everyone), web applications 
can customize pages for each user based on 
information learned about them (by asking, watching 
their behavior, or based on information the customers 
enter) which means that the pages served are more 
customized, dynamic and change based on the users 
needs. These capabilities offer web site developers a 
much greater ability to track information, control 
information, and get input based on browsing habits 
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and so on. With application servers the site can audit 
what the users are doing, where they are going, and 
how users are using the site. Instead of serving ail 
pages and information to a user, the site can prefilLer 
that information and give the user only what they have 
interest in. This can save bandwidth, helping 
performance of the web site, and reduce costs. 

Application serving can also save companies in the 
design and maintenance time of a website. It allows 
designers to look for commonality, and instead of serving 
many near identical duplicates of the same page (that only 
vary slightly), they can have one page (common format) 
that fills in all the unique information based on variables, 
parameters and context. This means less duplication of 
effort, more code reuse, and higher degrees of 
consistency (again improving the user experience). 

So regular web serving is about almost all output, 
serving pages, and limited input; while Application 
serving is much more two-way, including many more 
possibilities that such as real input and bidirectional 
communication. This is analogous Lo Lhc differences 
between watching a TV show and clicking to change 
channels versus having a video conference and interacting 
with whoever is on the other side. Businesses can be 
collecting information as well as just spewing it out. 
Instead of only being able to spew information blindly 
they can instead send out the right information 
(information more likely to fit the context of what the user 
wants). Application serving gives a company's website a 
competitive advantage by allowing it be more powerful, 
pleasant and useful —which should result in a better user 
experience and more payoff for creating the site. 
Application servers allow companies to use this new 
medium (the web) to it's full interactive interconnected 
potential — and this is what web applications and 
WebObjects is all about. 

MIDDLEWARE 

WebObjects is an application server but is also 
what is known as middleware. In an n-tier client server 
solution you can have many layers of things going on, 
At the bottom tier you have your database and other 
legacy systems (the data storage), at the top tier you 
have your clients — and in between many other 
servers and services (tiers). Somewhere in the middle 
is the go-between and the integration solution — the 
key that binds it all together and makes many separate 
solutions feel like one integrated whole. That key is 
middleware, and in the Internet this is usually the 
application server (WebObjects). 

To be a good application server you need to be a 
great development tool and rich framework to allow 
companies to create applications quickly and cost 
effectively. WebObjects does this — however, the details 
are so extensive that it deserves Lo be a separate in-deplh 


article and will he available in a future issue [WebObjects: 
the Internet Application Development Environment]. Thai 
article will go into more depth about the tools, 
framework, and how WebObjects does what it does. This 
article will focus on what WebObjects is, and the other 
aspects of being a good application server: versatility of 
deployment and being an open solution. 

A good Wei? Application solution needs to be able 
to integrate many different systems into one cohesive 


Application Server or Database Server 

Since most application servers are serving information out 
of a database, it can be difficult to differentiate between wliat 
is a web application server and what is a web database server. 

I think of the differences based on the amount of business 
logic and state information involved. If you are only pulling 
queries (and getting results) directly to and from a database, 
then you are really only using the server as a front-end to the 
database. That is a database server. However, if you are doing 
lots of things with business logic, like tracking user state, 
processing Lhe data, doing calculations on the data, and so on, 
then dm is more a business application that is being served on 
the web — and what you have is an application server. 

There are many products like FileMaker and Tango. 
JBuilder, ColdFusion and so on, that are nice web database 
stiver solutions. They can deliver data from a database — but 
they choke when you try to do too much business logic or try 
to scale them beyond the one database they were designed 
for. Application savers can go way beyond just serving 
databases; they can often sene multiple databases and 
combine data. Application servers can manage security, and 
work with other systems (like FRP and commerce systems). An 
application server is a much bigger and broader solution than 
just, serving a database. It is more about processing that data 
in new ways, and being the intermediary (middleware) 
between many business systems. 


whole, and allow any part of the system to be replaced 
with some other system or Lo allow any part of the 
system to grow. Scalability is the keyword. 

Notice the drawing which shows the Application 
Server as the middle. Well, in a small organisation (low 
load) this server may be doing everything, You can start 
with a single server being all things — running a web 
server, an application server, and hosting the data. Over 
time, as your requirements change (voui load grows), you 
can add more servers, more services, and balance the load 
over many more levels and systems. This potential for 
growth in both features and scale is critical — because any 
downtime while seating up can seriously hurt a business. 
The multiple costs of conversion can put companies out of 
business. So a web application needs to be able to deliver 
that integrated application over the web, while still 
allowing any area to change or grow over time. These 
openness and deployment issues are another area where 
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WebObjects shines — and is critical to understanding what 
differentiates Wel>Objects from other solutions. 

Open Solution 

Using WcliOhjccts you can create great web applications, 
but there are many tcx>ls that can create applications -— so a 
differentiating issue becomes how do you deploy your solution, 
how open is the solution, how scalable and how well can it 
grow. Well good news — Apple is very open with this solution, 
and WebObjects solutions can really grow. 

On the Lop end (one side of die middleware) you need to 
interface with the client. WebObjects does this with the help of 
a web server. It doesn't just require one company's web server, 
like some competing solutions do. WebObjecLs lias adapters that 
allow iL to work with many different HTTP servers including any 
that use CGI* IS API, WA1 and NSAP1 interfaces. Which in English 
means Apache, Microsoft's IIS, and Netscape servers are all 
supported native. That covers about 95% of the market. 
Everyone else is covered through the use of the CGI interface — 
which while a little slower performing than the native interfaces, 
still works very well In face it works so well that many 
competing solutions only offer this slower interface. So with CGI 
support, it means that WebObjeas can interface with about any 
web server that matters and in the future, if something new 
matters, Apple or an interested third party' is likely to write 
another adapter to keep you covered. As a last resort, if you 
really need some new adapter then you can write your own 
(Apple offers source code for doing that). 

WebObjects itself runs on a variety of platforms, including; 
Windows NT, Solaris, HP-UX (!) and Mac OS X. Many of the 
competitors solutions are less open, and may only run on a single 
platform, or have other limiting dependencies. There are a few 
solutions that run on more platforms than WebObjem. 
WebObjects requires a nalive runtime for each platform, to offer 
Lhe highest level of performance. Native runtimes require Apple 
to QA each version and tune for each platform. Most of the 
solutions that allow more platforms are running interpreters, 
virtual machines or emulators of one soil or another, and so 
perform far below the level of WebObjects. Because of this native 
platform support, you can not just port the runtime yourself — 
Apple will need to support the platform by creating the runtime 
(and you aren’t going to get source code to their run time). 
However, WebObjects is still more open than most solutions in 
this area — and 1 think Apple made the right tradeoffs (better 
performance with the limitation of running on only four of the 
best platforms). Another key point of versatility to remember is 
that the WebObjects Application Serverfs) don't have to run on 
Lite same machine as the HTTP server, nor the database server, 
nor any of the other servers — and WebObjeas can still internet 
with all those others servers. 

At the back end (Lalking to the data stores and other 
servers). EOF enables the back end data to work with any one 
(or many) of the following databases as your back end — 
Oracle, Sybase, Informix, OpenBasc and any ODBC compliant 
database. 1 expect support for even more choice in the future. If 


you have a database that isn’t supported by default, you can 
write a plug-in on your own to fill that gap (or find someone 
else who will) — I’ve heard of people using IBM's DB/2 or 
Ingres among others. Third parties offer mainframe host 
applications, PeopleSoft and SAP support for the ERP side of 
things. WebObjects can work with Corba/MOP, DCOM, and 
java Beans — and there are extensions and services for security, 
directory services, mail, eCommercc and so on. Thus the back¬ 
end is also a wide open solution. 

The openness at every level gives me a lot of security and 
Confidence in the solution - and is another reason why 1 would 
choose this type of solution over something like ASP and a 
Microsoft solution, Microsoft's’ solutions tend to all be 
proprietary and lock you in to their tools; they work with their 
databases, their servers, only on their OS, and only using their 
development tools. Tliat concerns me. Apple has a complete 
solution that works well waih just about anything I can think of 
— and has hooks or plug ins (where possible) to make 
WebObjects an even safer, more open, solution. 

Conclusion 

This article should have given you a better understand of 
how Apple's Enterprise Solutions, and WebObjects, can rill some 
needs within your oigantzatfons -—and learn that WebObjects is 
the premier solution for creating web applications. 

Web applications allow companies to improve the Internet 
experience by changing the normal push only form of web 
distribution into a much more bidirectional (push-pull) 
experience. Web apps also allow companies to deliver far more 
services to their own people at many different locations (like 
around the globe), and using a web-based interface can reduce 
the costs of development and deployment* compared to 
traditional corporate solutions — all while increasing the quality 
of the user experience* 

WebObjects has many key customers, many deployed 
solutions. It has l>ecn proven over time, and has earned many 
industry accolades* WebObjects does critical things like save you 
money and offer you a safe path for growth. If you am trying to 
create some sophisticated web solutions, guarantee some 
scalability, have a high degree of openness and expandability in 
your design, and you want to leverage the most powerful and 
versatile solution out there — then Wel>Objects fits the bill. 
There doesn't seem to be anything else that competes as well in 
all the different areas — maybe this is why Wd>ObjecLs is 
the leading web application .soluLion. ®ti 

FOOTNOTE (1) Hewlett Packard has a few problems 
wit h their java implementation and the way their OS manages 
threading. Basically, UPs threads don’t work across 
processors in an MP environment, which means Lhat Java 
performance is noL optimal, and all the kinks aren't worked 
out yet. So if you are planning on an HP-UX deployment, 
then you should also plan on using Object!ve-C as your 
syntax. Things may change in the future though. 
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GETTING IT 
TO MARKET 


by Eric Long 


Software Installation Fundamentals 


Introduction 

If it absolutely, positively, has to be 
shipped overnight* then you probably 
should have considered your installer 
before now* On the other hand, if you 
began working on your installer six 
months ago, and have been tweaking it 
every day since, you've probably 
overdone it and have created an 
overwrought monstrosity, which no one 
but you may be able to work with kiLer 
Somewhere between avoidance and 
obsession is the happy medium, which 
should lx: the goal in Lhe creation of a 
software installer. 

How many times have you heard the 
phrase, "Keep it simple"? It's the mantra 
of UL It's also the best strategy for 
creating installers. Keeping it simple 
means breaking the problem down into 
bite size morsels dial anyone can 
swallow, not eliminating useful 
functionality. Many times, 1 have heard 
developers call or write and say things 
like, “My users are idiots, t have to 
protect them from themselves.” In most 
cases, that's just not true. Most users are 
not idiots. Most are intelligent, 
reasonable people who can and will use 
great functionality intelligently if you let 
them. They may not be a computer geek 
like you, hut they can follow your lead if 
you know how to lead them through it, 
(Granted, some users may be idiots, bur 
it's a very small percentage) Don’t judge 
your users by your worst tech support 
calls* Most users never make them* 


Building the Beast 

Before you create a software installer, you should have a 
clear sense of what you want to accomplish with the installer. 
The purpose of an installer is to do its job in a straightforward 
manner dial is convenient for users. It must a) install the right 
software for the right machine in the right places, h) provide 
the flexibility your users want to keep them happy, and c) not 
screw up the users system. An installer may also provide 
some aesthetic niceties like pictures and sounds, but niceties 
are secondary and are not the main focus of the installer, in 
fact, if all goes well, the best installers are the ones your users 
remember die least. Alter all, your users want your software, 
not your software installer. 

Getting Started 

Preparation is essential to development of a software 
installer, just as it is to the development of the software it 
Installs. Stuff!t installerMaker is the product i work with at 
Aladdin. Over the last year or so it has undergone serious 
changes. We've listened to a lot of feedback from customers 
in planning its development. My attitude through the process 
was to look at each need and ask, "How can we get there 
from here?" The same approach applies to building a software 
installer. Before providing the answers, you have to identify 
the questions. Below are some questions you should ask 
yourself before building an installer. 

What needs to be installed? 

This is pretty basic. What are the parts that you need to 
have installed? Most of the time you will have two classes of 
items: items that go into a main folder you install somewhere 
on the users system and System items. You should create a 
components list identifying each item to be installed and 
where it is to be installed. This information is the foundation 
of your installer. 


Eric Long is the lead software engineer for Aladdin Systems' StufOt InstallerMaker application, l te has been at Aladdin for 
three years, functioning as the InstallerMaker engineering lead For every version from v4.1 to present. 
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How will tills installer l>e distributed? 

Who will be the end users of this installer? 

Your approach to an installer will be quite different, 
depending on Lhe method of distribution you use and the end 
user of your installer If you distribute an installer on CD, you 
can afford to include parts that may not l>e essential, but are 
beneficial for users. If you distribute online, you will want to 
trim down the installer, by removing non-essential parts. You 
may also want to consider using different compression methods. 
Installer Maker supports a maximum compression method and a 
faster methi>d for compressing items in your installer. The 
maximum compression method gives you a much smaller 
installer, ideal IVvr updaters nr other types of installers distributed 
over the Internet. The faster method provides faster 
decompression. IT you are installing a large number of items 
from a CD, the faster method may fit Ixmcr with your needs. 

Knowing who will be receiving your installer is just as 
important as knowing how they will receive in Different users 
have different needs. For example, you can not always depend 
on users having specific OS software installed. If you know the 
clients of your installer all have Drag & Drop, then you don't 
need to install it for them. On the or her hand, if your product 
has some cool Drag & Drop enhancements, and some of your 
users may not have Drag & Drop installed, then you will likely 
want to license it from Apple and include ii in your installer. 

You may also have files Lhat are useful only to a small 
subset of your users, such as users from a particular country. If 
these files are large or numerous, you may want m consider 
building different installers for different groups of customers. 
This allows you to simplify your installers and to avoid confusing 
your users with choices that don’t apply to them. 

Once you have determined what to insutll and where to 
install you are ready to address the more precise issues of 
installing them: 

When does it need to be installed? 

When should U not be installed? 

What should I do about existing items? 

Nothing is more annoying than installing an upgrade only 
lo find that 32 items have been added to your System folder, half 
of which are extensions for PowerBooks (when you're installing 
to a desktop Mac) and five more are unnecessary for the OS 
version on your machine. Be considerate, If the machine doesn’t 
need it, don’t install it. unless the user explicitly requests to have 
it installed. 

Another big mistake is to actually downgrade a user’s 
system, I lave you ever installed M SuperGadget 2.0” and suddenly 
found that the latest update to QuickTime, which you spent all 
that time downloading and installing, has been replaced with an 
older version deemed “compatible” by the developer? Til bet 
your next move was to shout, 

If the software you are installing requires a specific version 
of a component lhat you don't fully own, inform the user and leL 
die user decide whether to downgrade. It’s inconsiderate to play 
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Rea I-world data management 
solutions are typically more complex 
when one examines the pieces, 
than initially recognized by the 
majority of database programmers. 
All software projects are complex 
puzzles comprised of ninny details, 
most of which arc data-rclated. Often 
today's “'DBMS” solutions sacrifice 
the speed or control essential for a 
competitive application. 

c-tree Plus , by FaiiConu lue* 
been the choice of commercial 
developers For twenty years precisely 
because it offers the flexibility and 
control at the detail level to fit a 


wide variety of data manage mem 
needs. Proven on large Unix servers 
and workstations, c-tree Plus’s 
small fool prim and exceptional 
performance have also made it the 
engine of choice For professional 
developers on Mac and Windows, 
c-trec Plus offers sophisticated 
ISAM level control with which the 
developer may define precise data 
management solutions, making it a 
perfect lit for any development 
project requiring specific data 
handling features. 


C-tree Plus® offers the most: 
mature ISAM solution today... 


FairCortVs 
c-tree Plus 
database engine; 

Advanced Indexing Technology 

* Complete Source Code 

■ Complete Transaction Processing 
11 ODBC Interface from 
Windows clients 

* Over 25 Developer’s 
Servers Included 

* Royalty Free 

- Standalone, Multi-user or 
Chent/Server Models 
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God with a users system. If you do fully own the component, 
consider whether you really must remove an older component 
before deleting it. For System level items, you may not have a 
choice, but for other items keep in mind that your user may want 
to keep the old version around. Maybe he really likes 
SuperGadget 1.0. Unless your installer is explicitly provided as an 
updater, try to leave the user's existing software intact. If you 
w r ant to avoid confusion, move the old items to a backup folder 
and name it "Old SuperGadget Folder." This is also a good place 
to put a copy of the user’s original preferences hie. 

If you provide your users with an uninstaller u> remove 
your software, take special care with System items. If you don’t 
wholly own the component, don’t remove it. Just because your 
installer installs the Text Encoding Converter extension, doesn’t 
mean you can then uninstall it! The user may have several other 
products dial use ihul extension. If a component you have 
installed is potentially included in other installers, even other 
products you fully own, you probably don’t want to uninstall 
that item, because it might break something else. 

What About Selection? 

Most installers have an all inclusive install package known as 
the "Easy Install/ 1 This is great for the user who doesn’t know 
anything or doesn’t want to know anything. He wants It simple; 
dick, install, done. Many installers are small enough, in terms of 
the number and type of items they install, that no other package 
choices are needed or warranted* Those are the exceptions, Most 
installers could include package choices other than an Easy Install. 

Creating Package Choices 

Users really appreciate grouped packages of items to 
choose from for installation. Tills allows them some flexibility in 
choosing what is or isn’t to be installed. To create custom install 
choices for your users, group the items you install into packages 
that you think your users might appreciate being able to install 
.separately. This is especially valuable if your user ever needs to 
reinstall a particular component (disk errors happen, files get 
corrupted). It T s really handy to lx i able to run ihe installer and 
grab out just the part you need to replace* 

About reinstalling... applications like Installer Maker allow 
you to assign conditions to determine whether a given item Is 
installed* Version conditions let you decide what to do if an 
existing file is present before installing. You could choose to 
install an item only if it Ls nearer than an existing item on die 
user’s system. lhat would be wrong! You should always choose 
to install if the item is the same or newer ; This way, if Lhe user 
needs to reinstall, when something isn’t working right, he 
doesn't have to know which component to remove before 
running your installer If you only install when newer, the 
installer would never reinstall because it finds the same item 
already installed. The fact that an item of the same version is 
installed doesn't mean there is no need to reinstall. 

Many developers fail to give much thought to providing a 
decent set of installation packages for users to choose from. 
Sometimes this is done in die name of "protecting dumb users." 


Sometimes it’s just laziness on the part of the developer. The 
larger vour installer, the more likely it is that your users would 
benefit if you sal down and worked out some groupings for 
them to choose from, for installation. 

Here arc some possible groupings you could use to setup 
your installation packages; 

* Easy Install 

Installs everything the user needs. If you include FAT 
components, this package would install them FAT, Easy 
Install is the package that demands the least from users, 
however, if you go overboard making decisions for users 
automatically in this package, more experienced users will 
lx* forced to avoid the Easy Install. A balanced package 
provides some leeway, for the convenience of all users* 

* Easy Install for your Macintosh 

Same as Easy Install, but strips FAT components for the target 
machine. 

* Minimum Install 

Installs lire minimum configuration the user needs to use 
your software* This may also strip FAT components* 

* Application Only 

If you are installing a main application, give the user the 
ability to install only the application if desired. You might 
also include a read me to emphasize other components 
required by the application, in case ihe user has not installed 
oilier required components, 

* System Items 

This includes anything you install into the user’s System 
folder. You could break this down into sub-packages of 
control panels, extensions, shared libraries and whatnot, 
linking together items that are dependent on one another. 

* Plug-Ins 

If your installer contains plug-ins for your application, or 
other subsets of files, it’s nice if users have the oprion to 
install those items independently from other installations. 
Tills is also a good place to offer $ul>package$ so users may 
explicitly chtxxsc to install individual items from this group. 

* Documentation and other Support Files 

litis package would include your online manual "Head 
MeV and other support files* You might want to include sul> 
packages so a user can choose to only install your "Read 
Me n s only install your "What’s New” document, or only install 
tite manual. 

* Goodies 

Maybe you have some extras you’ve thrown in for your 
users. Placing them here would give you some credit for the 
niceties you’ve added for them. 

If you care about your users, spend some time setting up 
packages* They will really appreciate it. Yes, some users may trip 
themselves up playing with custom options, because they don’t 
have a due. When they call just tell them to stick with ihe Easy 
Instal l. The majority of your users should not suffer because some 
lack an average sense of how- to use their computers* 
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Safeguards 

Safeguards are the things you do to your installer Lhai users 
think very little about, but which concern you greatly. This can 
range from art obsessive drive for control over the installation 
process, to simply providing key bits of information to users, 
which enable them to make good decisions on their own, about 
installation. As the software provider, you don't want your users 
to get bit during installation. Your users are just as anxious not 
to get bit. There's a fine line between protection and 
domineering. Making the right decisions here will save you 
hours of tech support. 

Here are some safeguards that are generally considered 
to be lame practice: 

* Installer won't let users override minimum system 
requirements 

[f 1 want to install a CFM-68K application on my PowerMac, 
that’s my business! At least provide a custom install option to 
install the files into a special "not for this system" folder. 

• Installer only provides automatic installation choices when 
multiple reasonable choic es exist 

1 might have a reason for having three copies of Netscape 
on my Mac. Don't just install a plug in without asking which 
copy to use ii with. 

* Installer automatically removes or makes incompatible all old 
components 

There are plenty of installers that do not need to upset old 
files.. If you haven't used SuperGadget 2.0 yet, you may want to 
go Irack to TO. It Isn't too much to ask for reasonable 
preservation of some old files, particularly files that cannot 
reinstalled because they are custom files created using TO. 

• Installer forces a restart or calls for a restart when nothing 
that was installed needs one 

• Installer needlessly quits all running applications 

• Installer installs a main folder, which could he installed 
anywhere, but provides no choice to the user as to where to 
install it, instead it always installs to the root folder of the 
startup disk or another fixed location 

* Installer modifies settings in files it doesn’t own without 
permission 

This list could go on an on. The point is that presumptuous 
installers are a bane to users. Don’t inflict these behaviors on 
your users without providing alternatives to avoid them. 

Here are some responsible and considerate safeguards: 

* Don't advise users to b<x>t with Extensions Off unless they 
really need to do that. In most cases, there is no reason to 
do this, unless your installer is hampered by virus protection 
software in some way 


■ Only quit all applications if absolutely necessary 

• Provide helpful alerts that inform a user before performing 
actions the user may want to know more atxnil, or may want 
to cancel from doing 

Example: l>o you want me to switch your default Web 

Browser for you? 

Example: SuperGadget is best suited for use on Macintosh 

computers w ith a monitor 

whose resolution is at least 640 x 480, which this 

computer does not have. 

Install anyway? 

Note: Tills can gel out of hand. Don't overdo it with alerts. Keep 
them dow n to only what's needed 

• Provide your users with concise descriptions of iastallation 
packages available to chix)se, 

• Backup the user’s files when needed, or let the user decide 
if that's something he wants to do 

• Be careful not to install items into the active System Folder 
that are incompatible or unneeded 

• If your installer downloads files from the Internet, let the 
user decide whether or not to continue before initiating 
the connection. 


StoneTable 

You thought it was just a replacement 
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We lied, it is much more l 

Tired of always adding just one more feature to your LDEF or 
table code ? What do you need in your table ? 
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Titles for columns or rows ? 

In-fine editing of cell text ? 

More than 32K of data ? 
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Sorting ? 

More ?? 

How much longer does the list need to be to make it worth 
$200 of your time ? 
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* Include an installation log to let the user know what the 
installer installed and other actions it may have taken, such 
as creating aliases, copying or removing files, or moving files 
to new locations 

* Give the user troubleshooting information and contact 
information in a separate document included with your 
installer, in case the installer encounters problems or is 
da mnged sc)inellt v w 

ITiere are many more useful safeguards that can be 
implemented. Choosing the right ones for your installer will 
benefit both you and your users. You'll have fewer tech support 
problems and users will appreciate the care you've taken to 
serve their needs. 

The Tricky Stuff 

When it comes to installers, you can Ixa there's some tricky 
issues that will come up in the process. After three years working 
with InstallerMaker, l still hear about new issues on a regular 
baste. The demands and desires for installers are as diverse as the 
demands and desires for software. Most of the problems your 
installer will face arc; handled easily, but some issues take a bit 
more thought. If you find you've painted yourself into a corner, 
don't give up. Where there's a will, there's a way. Just keep 
asking, “How can I get there from here? 71 

Tricky problems become a lot less tric ky as you break them 
down. When you encounter trouble accomplishing a task you 
have in mind for your installer, step back from it and ask 
yourself, “What do l really want to accomplish here?* You may 
be stuck simply l>ecuuse you've locked yourself into one 
approach to the problem. Look at the features of your installer 
making program and you will probably find that there are 
multiple angles available to address the problem. 

Gestalt 

Gestalt is your friend. Gestalt te a part of the Mac OS that 
lets you determine just about anything you would want to know 
about the Macintosh when your installer is running. Need to 
know if this Mac is running Open Transport? Does it have the 
Appearance Manager? Does it support QuickTime i? These are 
all questions you can determine die answers to using Gestalt. 

In InstallerMaker, multiple custom Gestalt conditions can lx* 
specified for individual archive items, installation packages, or 
even the whole installer. There are predefined conditions for 
many common system traits, like checking whether the machine 
is a PowerMac or lias a 68K processor. You don't need to create 
custom Gestalt conditions for those. You use custom Gestalt 
conditions for special needs your installer may have which are 
not covered through standard conditions. 

Use Gestalt selector to identify specific information about 
the Mac on which your installer is running. Gestalt selectors arc 
four character codes used to indicate the particular feature you 
want to know alxxit on the system. In InstallerMaker, you can 
choose from a popup menu listing most of liie available Gestalt 
selectors. Gestalt selectors can be set up and registered w ith the 


operating system by any program, so this is not a complete list. 
There are always more selectors. This list is drawn from selectors 
documented by Apple in the system header Gestalt.li. Jean- 
Pierre Curcio’s freeware application Gestalt.AppI is a very’ 
helpful tool for gleaning information about Gestalts. You can 
find it online, or in the files shipped with InstallerMaker. 

Once you have found the right selector, you can use it to make 
installation decisions in your installer, based on the results returned 
when querying Gestalt for the selector. In some cases, you may 
only need to check for the existence of the selector. Often, when a 
feature is noL supported on a given Mac, tile selector will not exist, 
Pur example, the otari selector, for Open Transport, does not exist 
on Macs without Open Transport installed. (This would require that 
the proper extensions are loaded, however, as is the case tbr many 
system extensions that register with Gestalt.) 



Got Milk? 


Dynamic Decision Making 
If this, then that, else the other thing. 

No doubt, you will encounter the above situation at some 
point, if you get to build many installers. Some installation 
dec isions aren’t as simple as, “only install this on 68K Macs* or 
“install this only on Power Macs." Sometimes the decisions are 
"if there's a copy of bleep 2000 installed then... else "move this, 
delete that, and copy those/' InstallerMaker provides lilts 
functionality in the form of Insiall When conditions. 

Suppose that you have a set of components youVc created 
called, “Bleep 2000 Plug-ins." Now, maybe you also have a 
similar set of components for working with a different 
application your users may want to use instead of Bleep 2000. 
You call these components “Zoop Plug-ins.” You could simply 
provide separate packages and let the user choose which to 
install, but ideally you’d like to have an Easy Install that handles 
that decision for users. 

This is a classic “if, then, else" situation, lliere are a number 
of ways Lo deal w ith situations like these, some are easy, some 
take a little more thought. 

InstallerMaker supports a number of tasks, which you can 
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implement to help deal with problems like these, along with 
Install When conditions. Tasks are available to find items on a 
users system, copy items, move items, delete, rename, or alias 
items. I here are also tasks for downloading files, launching 
applications <ir opening documents or folders, displaying alerts, 
displaying pictures, and playing sounds. These provide the 
oomph you need to conquer complex needs. 

MBFD Word. Picture. ^Picture Captions Tasks in 
InslallerMaker 

Install When conditions in InslallerMaker let you impose a 
condition about whether an item is installed or a task is executed 
according to the success or failure of a previous task or find 
D|>mrion. You could, for instance, install a succession of items 
only if l< Bleep 2G0CT is found on die user's system. Or, you could 
always install and just place the items into a folder where the user 
can access them later, when hl Bleep 2000” is noL present, or move 
them all to the “Bleep 2000 Plug-ins" folder if it is present. 

If Last Task/Ond Failed J 


If LastTask/FIntJ Succeeded 


pAlways R | 

Install When Conditions 

Another important feature of InslallerMaker and other 
installer making applications is the ability to set the installation 
destination of items being installed to a location to lie found at 
run-time, such as “where is Bleep 2000?* 

InslallerMaker is optimized to perform disk-based searches 


lor items based on the item's file type and creator type. If you 
warn really fast searching of a user's drives, this is the ideal way 
to go. Additionally, you can reduce the effon your installer has 
to make by using the same search criteria whenever possible. 
When multiple searches are specified which contain the same 
search criteria, they are treated as one search at run-time. 

All archive items in InslallerMaker archives can he set to use 
a Destination of “Find." The search criteria you specify becomes 
the locution where the item is to lx: installed. When the Find 
fails, the item is not installed. I ising Install When conditions, you 
can configure your installer to lake other actions based on 
whether the Find succeeded or not, like displaying alerts, 
installing alternate files, or executing spec ific tasks 



ImtuUerMakcr Find' Search Criteria Dialog 
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Find is also used in file and folder based tasks, like Move 
tasks Lliuii allow you to move tiles or folders on a user's system 
from one place to another. All such tasks include a source 
location field for specifying where the installer should look for 
the item on which it is to act, 

[f the source item is not found, the task fails. You have default 
error handling options, such as aborting installation, reporting 
the error and continuing, or you can ignore the error and 
continue. You may also choose to preserve the success/fail 
status flag so that Install When conditions are not effected. The 
Find task type exists explicitly for setting the Install When status. 

File and folder based tasks have both a Source Locution 
field and a Source Name field. The source name field Is left 
blank when die source location is the source item to acted 
on, buL if the source item is an item within the specified source 
location, the source name field is used to identify dial item by 
name. You may also enter a full or partial path into the source 
name field. If the path is a partial path it will lie resolved relative 
to the source location selling. If the path is a full path, the source 
location setting is ignored 


Source Location: 

Find... 


Source Name: 

Sleep 2000 Plug- tnsj 

If not found: 

[ Ignore error 

=3 


Using a Path as a Source Name 


Display Alert tasks can also be used lo set the Install When 
(lag status to success or fail, based on the user’s button selection 
from the alert. This allows you to give users some say in run¬ 
time decisions that may lx* important to them. 

fn some cases, while you are working out run-time 
decisions, you may find it handy to use the Temporary Items 
folder destination to put things. This folder is not visible to users 
and provides you with a workspace you can use during 
installation. Move tasks can be used to move items to other 
destinations, or you can use Delete tasks to remove items if they 
are no longer needed. 

Updating Existing Components 

Where is it? 

How many “its" are there installed? 

How do I decide which “if to use? 

OK, you're still looking for Bleep 2000 on your users system, 
only, “Surprise!" There's three copies installed! Now what? 

Well, your user may just have a cluttered machine, or your 
user may have good reasons for having more than one copy. 
This is a good time to lei the user choose the install destination. 

Tills process is not too difficult. Find can be configured to 
prompt the user if multiple copies are present. At run-time, the 
user will he prompted by a display showing the copies of “Bleep 
2000" found and where they are located. The user can choose 
whatever is best for them. 



/ hate nine versions of my Acme Widget program out there. 

Mow cart / update all those different versions! 

Updater chaining is what you need This is pretty easy too. 
You can create updaters in InstallerMaker using the different 
versions of Acme Widget. Each updater is nude by comparing 
an older version to a newer version. If you have nine different 
older versions, you'll need nine updaters. To get your users from 
1.0 to 2,0, you'll create updaters using each successive version. 
First 1.0 to 1.1. followed by 1.1 to 1.2 and so on. In this case, 
you would probably be better off just installing version 2,0, but 
if your needs were more real-world, updaters could make your 
installer a lot smaller. 

Once you have your updaters, you need to set the install 
destination to Find, specifying the criteria to locate Acme Widget 
(using type and creator is the most efficient method). In addition, 
for each updater, set the Find to look at the version of Acme 
Widget found. The first updater would only update the oldest 
version, if the copy installed is newer, dial updater would not 
execute. Updaters following would only operate on the specific 
version each was created to update. In the end, only the updates 
needed are executed. You can use a Display Alert task in 
conjunction with an Install When condition to post an alert if no 
eligible copies of Acme Widget are found for updating. 

Linking Installations 

It is not uncommon for a software provider to have 
multiple installers for different components. The installer For 
the Mac OS integrates more than one installer into a single 
installation process for users. This is easy to do when you arc- 
in control of the various installers, launch tasks can be used 
to run one installer following another. It gets much trickier 
when you need to run software installers that you did mil 
create and cannot modify, Ii is difficult to launch them in order 
of need, and some installers cal! for a restart following 
installation. You don't want your user to have restart several 
times when only one restart is really necessary. 

Stufflt Installer linker™ is a nifty little application, included 
with InstallerMaker, that allows you to manage multiple installers 
and suppress restarting until the entire installation process 
completes. This utility will help you to manage this problem. 
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Produc t Serialization and Other Propkiltary 
Installer Extensions 

Installer making programs are powerful, useful tools, but 
you may have in mine I some things for your installer that go 
beyond what they provide, IJ you like to register software before 
your user installs it, and want them to enter in a registration code 
and such, you will likely want to create some custom code for 
this purpose. InstallerMakcT provides example code for product 
serialization* which can Ik* used genetically, but you'll probably 
want something a little more proprietary. If so, you will need to 
create an installer extension. 

Installer extensions are code resources that execute during 
the operation of an installer. Custom cede can be executed at just 
about any point during an installation, run prior lo installation, or 
run following installation. These can be extremely effective, 
providing you with a lot of control over installation and allowing 
you to inject your own tricks into the process. 

InstallerMaker supports code luxiks that execute prior to 
installation, during package selection, before and after (and in 
some cases in the middle of) installing an item or executing a 
task, following installation, anti at quit. Sonic extensions allow 
you to change installer settings while it is running. Some 
implement custom install conditions. You can also pass 
information between your code extensions using rcfCon 
parameters. Just about any place you would like to get a hand 
into, you can through custom code extensions. 

Marketing and Lawyers 

After dealing with all of the technical issues your software 
installer will face, youl) find there’s more than enough opportunity 
to slip in the pieces your marketing and legal people want in place 
before shipping. Standard installer features like startup pictures, 
startup text, software license agreement text, and custom progress 
dialogs are ideally suited for these needs. Your installer's startup text 
is also a gtxxl place to convey useful tidbits to your users prior to 
installation. Note, however, most users click past those screens with 
the speed of the space shuttle. If you want users to actually read 
them, you'll have to give them some visual flair, such as 24 pi bold 
text in red that reads, “Warning* Failure to read this document could 
result in acne, sharp intestinal pains, or death!” 

In my experience, most installers IVe seen simply use the 
default installation progress. This is perfeedy fine for installation. It's 
nice and functional, But, if you have marketing or PR goals in mind, 
this is a place worth taking advantage of, because ii is shown to the 
user throughout installation. All you need is a custom picture. 
Modify a couple of rectangle spedficatioas in ResEdit, and you're 
on your way, A custom progress screen can really shape the fed of 
your installer and personalize it for your company or organization, 

InsLaRurMaker also supports tasks that allow you to display 
picture banners during installation and/or play sounds. These 
can be very meaningful marketing opportunities. They can also 
provide bits of instruction or useful information you want to 
ensure your users to see or hear during installation. 


Niceties 

Appearance 

Now that your test people, marketing people, and lawyers 
are happy, you can think about some of the extras that make 
things pretry for users. In the Mac world, we go to a lot more 
trouble than our Windows counterparts to make things nice for 
users. For instance, setting folder views and icon positions is 
foreign to PC users, bur Mac users have come to expect it. 

InstallerMaker stores icon positions and other Finder data at 
the Lime an item is stuffed into an installer archive. To achieve the 
optimum appearance, try to stuff all of your items under the same 
version of the OS, and when you replace existing items in your 
archive, make sure that the new items come from the same folder 
in the Finder as you stuffed previously in your archive. If you 
replace a folder outright in the Finder, then you should replace it 
outright in your archive, or you may get inconsistent settings. 

Root level archive items, destined to lx“ installed into rhe 
same folder at install time, should also lx* stuffed from the same 
folder in the Finder. If they come from different folders, you will 
gel mixed icon position results. If your installer creates a user- 
specified folder, be sure and configure the installer’s settings for 
that folder so the size and view match the folder on your 
machine. InstallerMaker lets you specify the folder in the Finder 
to match, and at build time writes the folders current settings 
into the installer. 
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Uninstallers 

Uninstallers are another nice feature. In general, most users 
won’t use your uninstaller unless you install System items. You 
probably don't want users to remove your software, but this m a 
decent feature to provide for those who require iL 

Internet Support 

Internet support provides a means of live contact between 
you anti your users, allowing you to provide extra value to 
them, which they may not otherwise receive. Today’s installers 
can easily be setup to link to a server and download the latest 
updates of your software, or some extra goodies your users 
might like. InstallerMakers “NetInstall !Mid M extension is useful 
for checking versions of files on a server before downloading 
them. Your users might also like having options to download 
demos of your other products. 

Just ensure that your users are ready and willing to go online 
liefore logging on for them. 

Online Registration 

Gathering information about the users of your software is 
important. No longer are you limited to getting users to mail in a 
registration card though, registering online is now the easiest and 
fastest way for users to register InsiaNerMaker provides support 
for registering on the web, via email, or by traditional methods 
like standard postal mail and FAX, 

Aliases 

You can install aliases for the convenience of your users, 
especially if your users may not know how to create them. 


Personally, I object to having new aliases installed on my desktop 
after an installation, but l imagine it is helpful for many users. 

Automatic Application Launching 

Your installer can automatically launch your application 
following installation. 

Troubleshooting Help 

You may be able to determine things about the user’s system 
during installation that would l>e valuable to point out to your user 
If your installer notices that incompatible extensions arc present on 
the system, it doesn't hurt to point this out via an alert, 

Consideration 

Consideration is what niceties are all about. Niceties are not 
the core purpose of your installer, but a little thoughtfulness can 
l>e very good for Ixxh you and your users 

Successful Completion 

WeO, you've made it Lo here. 1 hope? you have gathered some new 
thoughts about installers that help you in the future. If you encounter 
a problem that you can't find the answer to, nag for it. You’d be 
surprised how many features are added into InsiaUerMaker because 
one person made a com lulling case for ii. Even if you don’t have a 
compelling ease, you can at least count on the squeaky wheel getting 
the grease! Keep asking for what you want. 

You can download a fully functional copy of InstallerMaker 
from the Aladdin web site at: www.aladdinsys.com. For more 
information about InstallerMaker contact Aladdin Developer Sales 
<dev.sales@afaddinsys.com> or Aladdin Developer Technical Support 
<dev.sypport@aladdinsys.com>. 



The MacTech CD-ROM with THINK Reference is the 
essential reference resource for Macintosh programmers. 
This CD includes the THINK Reference personal data¬ 
base system and a wealth of Macintosh programming 
databases, featuring over 160 issues of the journal of 
Macintosh programming — MacTech Magazine.This 
release also features the 'HUNK Reference Compiler, 
which allows you to compile HTML files into your own 
compact, searchable THINK Reference databases. 
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PROGRAMMER'S 

CHALLENGE 


by Bob Boorntm, Westford, ALA 


Peg Triangle 

Welcome to the New Year! If you're not one of those 
people who quibble about whether the new century starts in 
2000 or 2001, welcome also to a new century and a new 
millennium! As I write this, I cant be certain whether the 
doomsday predictions will turn out to have had any validity, 
but I r m betting that as you read this, the lights will be on, the 
telephones will work, the ATMs might be occasionally short of 
cash, the grocery stores will be replenishing their canned 
goods, and the pundits will be questioning what the fuss was 
all about. (At least this is my prediction for the so-called First 
World - I’m not dose enough to the situation in the rest of the 
world to lx? as confident) Of course, as someone whose Real 
Job included making certain that this transition to January was 
as boring as any other, 1 know that there was a lot of hard 
work invested in ensuring that life went on in the IT world. 

But fm betting that most of you are ready and able to take 
on this month's Programmer's Challenge. Especially since most 
of you are presumably Mac users, who didn't (or don’t) have 
Lo go through the complicated process of remediating their 
Monopoly-OS machine so that it would continue to function. 
We re going to make ihe Challenge a little simpler this month, 
in hopes of encouraging some new participants to take a shot 
at making the Top Five. 

A while back my daughter presented me with a puzzle site 
had made in wood-shop. (Yes, my town has progressed to the 
point where the girls take wood-shop and metallurgy classes and 
the boys take cooking and sewing.) The puzzle is a triangular 
block of wood with holes drilled into a triangular pattern: 1 hole 
in the first row, 2 holes in the second, etc. A peg occupies each 
of the holes, except one. The puzzle is solved by a sequence of 
jump moves, where a peg jumps over an adjacent peg into an 
open hole in the same direction, after which the jumped peg is 
removed from the board, The object of the game is to remove 
all of the pegs from the board, except one. 

Our Challenge will lx; a slight generalization of this puzzle. 
The initial Ixxird position will always contain at least one vacant 
hole, but perhaps more than one. The object will be to minimize 
the number of pegs remaining on the Ixjard at the end of the 
game, but l>eeause of the initial configuration it might not be 
possible to reduce the number of pegs remaining to one. 

The prototype for the axle you should write is: 

#if definest_cplusplus) 

extern “C" f 
#endif 

typedef struct Trian&ieFe&Position 1 
short rnw; F ft..numbt-rOfRows 7 

short col: F -niw, <nw+2.+rc>w 7 

I TrianglePcgPositIon: 


typedef struct PegJump l 
TrianglePegFosition from: 

TrianglePegPosition to: 

// must satisfy 

// ((to row “ from, row) && (lo.col == from,col +* 4) && 

// ((from.row +* 1. fronted +*2) occupied) 11 

// (to.row == from.row +- 2) && (to.col = from.col +- 2) &<& 

// ((from row +-1, from .col +* 1) occupied)) 

) FegJump; 

short F number of moves 7 SolvePegTriangle ( 

short triangleSize* F number of rows in triungle to solve 7 
short nuttlnitiaiPegs, F number of pegs in starling pu^Ic position 7 
TrianglePegPosition InitialPegPositionsU, 

F peg locations in starting puzzle position 7 
Peg Jump peg.Jumps!] 

F return peg moves tha! solve the puzzle here, in sequence 7 

); 

#if defined(_cplusplus) 

t 

#endif 

Your SolvePegTriangle routine is provided with the initial 
puzzle conditions and must store the moves required to solve the 
puzzle in pegjumps. returning from SolvePegTriangle the number 
of moves in pegjumps, As initial conditions, SolvePegTriangle is 
given the dimension of the puzzle (triangleSize), the number of 
pegs in the initial puzzle state (numinitialPegs), and the position 
of those initial pegs. 

The winner will be the solution that solves a sequence of 
puzzles at the lowest cost. Each millisecond of execution time used 
lo solve tiie puzzles will incur a cost of 1 point. Each peg left on 
the board beyond the first will incur a cost of 1000 points (whether 
or not it is possible to remove all but one [>eg from the board). 

Tliis will be a native PowerPC Challenge, using the 
CodeWarrior Pro 5 environment. Solutions may lie coded in C, 
C++, or Pascal. Solutions in Java will also lie accepted this month, 
Java entries must be accompanied by a test driver that uses the 
interface provided in the problem statement. 

Remember that you can gel a head start on the 
Programmers Challenge by subscribing to the Challenge mailing 
list See www,mactech.com/progchallenge/ for details. 

Three Months Ago Winner 

The October SuperDuperGhost Challenge attracted entries 
from four of the top six contestants in the Programmers 
Challenge points standing, and die top two in the points standing 
finished one and two. Cbngratulatioas to Ernst Munter (Kanata, 
Ontario) and Tom Saxton for finishing first and second, 
respectively, in the Ghost Challenge, 

The SuperDuperGhost Challenge required contestants to 
compete in a tournament, where the object was to win a 
generalized game of Ghost. The concept of Ghost is simple - 
players spell a word, taking turns adding letters, trying to avoid 
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being the one to add die last letter to a word in the dictionary 
Super DuperGhost complicated the original game by allowing 
the addition of letters to the end of the string, to the beginning 
of the string, to the loginning or the end, or finally at any place 
in the growing string, depending on the mode of the game. 
Scoring was based on winning games, with a penalty based on 
execution time, and an additional penalty for forming a word 
without declaring yourself the Loser. 

Bach of the four entries in the Challenge competed against 
every other entry, with each player having a chance to play first 
against each other. With four entries in this Challenge, that 
meant that there were 12 matches in each round, of which each 
entry competed in 6. I conducted 10 rounds of competition, 
times four game modes (addloEndOnly, adtfToBeginningOnly, 
addToBegin ni ng 0 rEnd, addAnywhere), for a total of 480 matches, 
with each player competing in 60 of each type. 

Playing first had a significant advantage, Ernst's winning 
entry was successful in every single match where it made the first 
move, regardless of whether the game mode allowed additions 
to the beginning, end, beginning or end, or arbitrary location 
within the growing word string* Tom’s second place entry did 
almost as well, winning 117 of the 120 matches where it played 
first. The third-place entry of Sebastian Maurer won all of the 
entries where it played first for the game modes in which it chose 
to compete; however, Sebastian only had time to complete code 
for two of the modes of the game (addToEndOnly and 
addToBeginningOnly), The table below lists the number of wins 
achieved by each entry in each of the four modes of the game. 



Wins 

Wins 

Wins 

Wins 


iiddltul 

addikgirmmg 

iiddFither 

addAnywhere 

Fmst Munter 

38 

40 

50 

49 

Tom Saxton 

39 

40 

49 

45 

Sdfcisttan Maurer 

39 

40 

0 

0 

JG Hdthcock 

4 

0 

21 

26 


In the addloEndOnly and addToBeginningOnly modes, 
Ernst employs a recursive solution to find a letter that does not 
complete a word, but which forces an opponent to complete a 
word. If a win cannot lx? guaranteed, he selects a letter that 
admits solutions where his opponent must complete a word. 
Depending on the dictionary, this strategy always succeeds 
when Ernst moves first and sometimes succeeds otherwise. In 
the other two game modes, the code attempts to force the 
opponent to complete a word, but otherwise tries to guarantee 
that the opponent is forced to make a word shelter than the 
shortest word Ernst can be forced to make. 

’Ihe table below lists, for each of the solutions submitted, the 
total score achieved, the execution time in milliseconds, the total 
number of wins achieved, the number of wins when playing first, 
and die size and language code parameters. As usual, the number 
in parentheses after the entrant's name is the total numlxr of 
Challenge points earned in all Challenges prior to this one. 


Name 

Score 

lime 

Total 

Wins Code 

Data 

Lang 



(msec) wins 

play first Size 

Size 


Ernst Munter (527) 

17700 

979 

177 

120 10412 

2019 

C++ 

loin Saxton (128) 

17250 

2575 

173 

117 6132 

637 

c 

Sebastian Maurer (70)7900 

1157 

79 

60 4448 

1B7 

€ 

JG Hdthcock (39) 

5000 

1543 

51 

28 2856 

97 

C 


Top Contestants 

listed here are the Top Contestants for the Programmer’s 
Challenge, including everyone who has accumulated 10 or more 
points during the past two years* The numbers below include 
points awarded over the 24 most recent contests, including 
points earned by this month’s entrants. 


Rank Name Points Rank Name Points 

1. MunLer* Ernst 23 7 10. Ma llett, Jeff 20 

2. Saxto n, Tom 126 11 * Jones, Penn is 12 

3. Maurer, Sebastian 77 12. Hart, Alan 11 

4. Boring, Randy 66 13. I Jewett, Kevin IQ 

% _ Riekcn, Wiiickc 51 14* Murphy, ACC 10 

6. I leithcock, JG 43 15. SdenguL, Jared 10 

Shearer, Kob 34 16. Smith, Brad 10 

8 r Brown, Pat 20 17. Stroutjoe 10 

9* Hostetter, Mai 20 18. Varllly, Patrick 10 
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object-relational database engine 


The fastest database engine 
_ for the MacOS _ 

It operates 100's and sometimes a 1000 
_times faster than other systems 


Valentina - scriptable database application. $49 
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Valentina SDK for C++ developers .$499 


- MacOS and Windows 95/98/NT versions* cros$-pJatform databases. 

- Support for almost any tyj>e of field: 

b(xi Lbyle,short, lo ng* floa t ,doi iblc*date , 1 i me, st ri n g B LOB /TEXT, Piet u re. 

- Support for indexing and sorting of iniemaiioml languages. 


- SQL random-access cursors. 

Multi-threading capable. 

- Record locking. 

- No runtime Tees. 

Valentina for REALbasic plugin ....$199 

Valentina for Macromedia Director Xtra.$199/299 

Valentina for WcbSiphon. .$299 
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from Our Web Site_I-Iostpd by MacServe.net 
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Theft* are three ways to earn points: (J) scoring in the top 
S of any Challenge, (2) Ix-ing the first person to find a bug in a 
published winning solution or, (31 being the first person to 
suggest a Challenge that i use. The points you can win are: 


Isl plate 

20 points 

2nd place 

10 points 

.3rd place 

7 points 

4th place 

4 poinLs 

Dili place 

2 points 

finding hug 

2 points 

suggesting Challenge 


Here is Ernst's winning Ghost solution: 

GHOST-V2.CP 

Copyright © 1999 
Ernst Munter, 

Kanata, ON. 

Canada 

r 

October y 19W. 

Submission to Mailed) l*fognmwRT,s UuIIchkl' for October 99. 
Copyright :0 1999. Ernst MunteT,Kamta T ON. Canada 

‘Super Dupcr Ghost" 

Version 2, 

Problem SULtmiU 


The program plays it game JShiwt against one other player Given a dictionary, and .in 
initial ghost string, one kiter must he added to the ghost siring without milking ,i 
dictionary word Itut liu new ghost string must be pun of a dictionary word. 

There are four game types; 

{()) add a tetter only to die cnd of the ghost string 

(I ) add a tetter only to ihe beginning 

Cl) add a letter only to the either the end or the beginning 

(5) add 2 letter anywhere 

Solution Strategy 


At each stage uf ihe game the current ghust string Lx incremented by one letter to 
yield a new ghost siring. I*mccssing at each stage in the game is independent of 
previous steps, A wordlnVIind" at one step may Ik- completely different from the 
worth n Mind at the previous or the next step, 

A full lookahead is employed for game Type (in. using recursion,The objective I* to 
Rnd a letter which does not complete a word, hut which forces the opponent tci make 
a word 

Depending on the actual dictionary, tills strategy leads to a certain win wlttmever 
possible. 

If a win cannot be assured by the lookahead search. I select a move which prefcnUy 
includes wortls the opponent must make hut of course, the kited staid) means that 
the opponent can win if they play correctly. 

The strategy for game type U> is identical. In older to lx - able to use the same code, 
ah working strings are reversed, and tiie lookups are done w ith a sorted inverse 
dictionary in which all words are- reversed (PLAIN becomes N1ALP) 

Modes 2 amt \ 


Game ty|x*s 2 and 3 are more complex and the strategy fix these modes is slightly 
different tu account for the more difficult job of finding valid target worth. 

Some of the cmlc from the Disarehtguator Programmers Challenge o| July 1997 Is 
reused to provide a method for finding dictionary winds matching ghost strings 
according to modes 2 and 3. 


Hut because tills lookup is not as fast ;is die direct binary search used in modes fl and 
l, hill lookahead cannot he accomplished in a short enough time. So only a simple 
heuristic is used: 

(lie words are conceptually Med into odd ami even sets.A player who starts will 
loose if be makes a word with an odd number of tetters. Conversely, lie can win if he 
can force the opponent 10 make an even length word 

The choice of the next tetter to play Is thus based on an analysis of all possible next 
letters, in all possible positions in the ghost siring 

The first choice, if available, is to use a letter that results in only w ortls die opponent 
can make (thus guaranteeing a win). 

The second choice is to use a letter where the shortest word T can make is longer 
than the shortest word the opponent can make 

Optimizations 

llic moves for ghostStrings of length 0 and I are cached to avoid recomputalioo w hen 
several games are played 

Assumptions 

Dictionary words are at least 4. and at most 31 characters long. 

Dynamic memory allocated by rile program for the inverse dictionary and the 
disambiguator tables b about 2.4 bytes per word of the original dktmnary (depending 
on actual average wotxl length) 

Static memory is about 2K. 

7 

//define DBG 0 

//Include M ghost,h" 

//include “nevdisainbigJf 
fine 1 ude H 'mySt ring- h" 

//include <string*h> 

//include <stdlib.h> 

(/if DBG 

//include <rtdio.h> 
lelse 

//define MDEBUG 

^include <asserl.h> 

/- 1 1 ' typedefs *”**** 

typedef unsigned long ulong; 
typedef const char* charPtr: 
struct Car.heType t 

ulong response ;// (msertuffi. point « 8) + diameter 
charPtr* word Inf! I nd; 

I; 

typedef CacheType Gache[1 2 ]; 

static charPtr* gDictWords; 
static long gNlimWord s: 
sialic char* glnverseChars; 
static charPtr* gTrcversseDlct; 
static GameType gGaiieTypc; 

// Selection of character orders for faster convergence 

static char* gSearchGrder="JQXZWKVFBYHPMGtJDCLOTNRASTE M : 

Static char* gA11e r na t eO rd e r-"!ISARNTDLCDUGHPHYEJL*'VKWZXQJ*j 

// Caches of the 1st and second character choices 

static Cache ruche[4]; 
static CacheType* choices; 

/*""™“” Utilities- L - ::; -- ,rru ./ 

Clea rCadics 

static void ClearCachesO 

I 

memset(cache * 0,siscof(cache)); 
choices=cache[0]: 

1 


Reversestring 

static void ReverseStringtchar* s.int ianj 
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char* i a s; 
char* r=s+len-l: 
char t“*l 

for (Int i-l;i<len/2;i++)I 
char t=* I U:*l=*-r: , r=t; 


Expand 

inline void Expand(char* nevGhost.char* fragment. 

int newGhostLen.int insert) 

// copy fragment into newGhnst, leaving space for insert 

l 

suncpy(ncwGhosl * fragment, insert ); 

KLrncpy{i]ewGiiusc+iiiHert+l. fragment l+Iilscz L , uewGliu s lL cn 
insert}; 

newGhosrInewGhostLenJ-O: 


CmpStr 

static ini CmpStrCconst void' a,const void* b) 

[ 

return StrCmp4(*((ebarPtr*}aj , *((eharPtr 1 )b)); 

} 


IsinDRl 

static charPtr* TsinDict(charPtr s) 

I 

charPtr* 

x=(L*harPtr*)bseardi(&a i gUici.Words,gNumWords t 4.CitipSit); 
return x: 

I 

(ictChsuftisiUons 

static void GetCharFonitiotinC 
char* ghostString t 
Ini ghostLen> 
const char* word, 
int* charPositions] 

I 

// Collects character positions for mode 3 from actual word 
int k~ 1i 

For (int 1=0; Kghost hen; i++) I 
char c - 'ghostString: 
char d; 

while (0 1= (d=word [++kj)) i 
if (c^d) break; 

1 

if (d=0) 
return; 

charPositiom [i ]”k: 
ghoatString+i; 

I 


// Customized heap sort for the inverse dietionary 

Send 

static void Send( 

// Inserts word wp in wordlist as a priority queue 
// in preparation for sorting biter 
charPtr vordListfj, 
charPtr wp, 
ulong nuraWords) 

( 

charPtr* haflerwordList-1: 
charPtr 

long i=rtxuiiWorda+l * j=i»l; 
while ((j>0)&&StrCjnp4(wp, Sybase [j]) >0) I 
base[ij^z: 

i*3; 

j=i»l; 

I 

faasefi] =wp; 


Sort 

static void Sortf 
charPtr wordList1J , 
long nuroWords) 
l 


// Heap soil step 2, viscxl for final sorting of the wordList. 
charPtr * sList“wordList-1; 
charPtr x: 
int i, j: 

charPtr* b=sLlstkiumWords*I; 
if (numWords)!) do I 
I 16 *!; j**2; 

x^sList[numWords ]; 

‘(b) = sList[l]; 
if £nimWords< = l) I 
sList[li^x; 
break: 
t 

while £j<**mimWords) [ 
if ((j<numWords) 

£StrCiEp4(sList [j ] , sLisL [ j+1 ] ) <Q) ] 

j++; 

if (StrCmp4(x,?Listlji)>"0) 
break: 

sList(i|=sListf j]: 

1 

sLisi[i]=x; 

\ while(1): 


The inverse dictionary ,tF " +i "7 

stcjlk' i ii L ScauDictO 

I 

// counts characters in alt dictionary words 
int mim=Q; 

const charPtr* d=gDictWorde; 

for (int i=0;i<gNumWordfi;i+d*d++) 

I 

tnjtu+-SLrt f cn4(*d); 

I 

return num: 

1 


ScanCHa 
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ChooseOl 


InverseCopy 

static along ChooneOlC 

cha r * fragment, // word fragment (ghosi string) 
ini fragken, 
charFtr* diet) 

// Recursive search for best next character, modes 0 and 1 

// Returns diantttplay that would force opp to make a word 

1 


static void TnverseCopy(int numChars) 

I 

if Copks/tavrcts all worcte from gjDictWords to glnverscDict 
// by doing a character by character copy back to front 
const charPtr* d^gDictWords; 
char* desi=gInverseChars+numQiars; 
int numWords-Oj 

for (int i=0:i<gNumWords;i++.d-H-) 

[ 

T desi=0: 

const char* sre“*d; 
while (*sre) I 
*—dest “ 

I 

Send(glnverseDict T dest,numWords-H-): 

1 

] 


MakclnvcrscDict 

static void MakelnverseDictO 

t 

if (glnverseDict) // already initialized 
return: 

in t riumCha r e^ScanOi c t {); 
glnverseChars=new char[numChars+gNuraWords] ; 
gInverseDict=new charPtrlgNuroWords] : 

InverseCopy (numGha r s+gNumWords) ; 

Sort(glnverseDict.gNumWords); 


DcIctelnmscDjcr 

static void DeleteinverseBict(] 

( 

if CglnverssDict) 1 

delete [] glnverseDict; 
gInverseDict=0; 

1 

If (glnverseChars) i 

delete I] gInverseCharst 
gInverseChars=0; 

J 


/************ Rinding ghosts in a dictionary ***********/ 


CrapFragmcnt 

static int gLength; 

static int CmpFrfigment(const void* a,const void* b) 

I 

return strnc&pf*((charPtr*)a) t *((charPtr*)b).gLength); 

1 


FindFirst 

static charPtr* FindFirst( 
charPtr fragment, 
int len T 
charFtr* diet) 

{ 

charFtr* x; 

I 

gLe.ngih**len; 

x-tcharPtr* JbsearchCSrfragment .diet ,gNu]nHqrda t 4, 

CmpFrapsent) : 

it (fitrnemp(fragment,*x.len)) 
return 0: 

while (x>dict) t 
charPtr* y~x-1; 
if (suncrap(fragmvi i t. *y f leu)) 
break; 

*nn 

i 

] 

return x; 


Z****** 4 ****** 4 Choosing the next move “*•**»*«““•-**/ 


//Try the whole alphabet, least used letters first 

char* tryChar=gSearchOrder; 
do ( 

// tack a character to ihe end of the fragment 
f ragment[fragLen-1J ^* tryChar; 

// find the shortest matching word in the diet ionary 

charPtr* x=FindFirst(fragment.fragLen,diet): 
if (x )\ 

If ((*x) [fragLen]—0} I 
// bad choice: wc must not make a complete word 
continue; 

I else ( 

// call opponent's choice, see if they can win 

char next=Choose01(fragment,fragLen+l,diet); 
if (next=0) I 

// opponent is forced to make a word, caller wins with this rhol co 
return * tryChar; 

1 

1 

) 

I while (*++tryChar): 

// remove letter arid terminate shorter string before returning 
fragment [f ragl-en-1) "0; 

// failed 

return 0; 

1 

//if DBG 

static int S [41; 

/fendif 


Choosc23 

static ulong Choose23(char* fragment,int newGhostLen) 

// Search for best move for modes 2 and 3 
// Returns character and insertion point packed in <16 bits 
1 

□long bestResponse"'0; 

// words arc in groups according to length, even and odd, 

// myGroups contain words I would complete 
// opptmups contain words the opponent would complete 
int myGroups=nowGho£tLen & 1; 

//define oppGroups (I * ray Groups) 

//define MYGROUF(x) f0 — (((x) A newGhoatLen) & 1 ) ) 

//define OPPGROUP(x) {(M = t(Cxj ^newGhostLen)fcl)) 
int step^l: 

if ({gGameType=a d d To Be ginningOrEnd} && 

(nevChostLenH)) 
step=newGhostLen■1; 

int delta.bestDelta= 64: 

for (int inserted;innert<newGhostLeniinn6rt-H=stnp) 

I 

char newGhost [32] : 

Expand(newGhost.fragment.newChosthen*insert); 
char* tryCbar; 

if (newGhostLen=l) tryChar=gAlternateOrder; 
else tryChar-gSea rc hOrder; 

do t 

mjwGhost[insetlJ = * tryChar; 
int shortest[2]; 
int numGroups= 

PbottestKatches(nevGhost,newGbostLen,gGatneType f shortest); 

if (numGroups*=0) it The fragment is nol found in any word 
continue: 

if (nuraGroups=l) 

( 

if fiYGR0UP(shortest[0]) I 

if (shortest (Ol = newGhostLen) I 
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// musi never make a dictionary word 

cun t i iiuo ; 

I 

// Mygroup words arc badt, opp loose only if they make a mistake 
delta-shortest[U J-f>4: 
if {delta>bestDeita) ! 

// But keep longest <tf these chokes, it may lx: all we have 
bestBe 1 ta^delta; 

best Response* 3 ’ r.ryChar + (insftrt«8); 

I 

\ else \ 

// I am guaranteed to win, return Immediately 

bestRe&ponse^tryChar + (insert«B); 
return best Re spouse; 

I 

1 else I 

//Words in both groups Keep the one with the highest delta, 

// that is where opponents wo rdf s) are shorter than mine. 

it iCfCROUf(shortest[0]) l 

if {shortest 10J—newGhostLen) I 
// must never make a dictionary word 
continue: 

I 

delta”nho rtest[0]■sho rtest(J ]; 

1 else I 

if (shortest [1 ]=newGhustLt'ti) [ 

// must never make a dictionary word 
continue; 

I 

delta^shortestfl]-shortest[0]: 


if (deltu>bestDelta) f 
bestDeita=deitar 

bestResponse-'tryChar + {insert«8); 


J 


] 


3 while (*++iryChnr); 

1 

return bestResptmse; 


Haying the next move 


static eharPtr'* PlayHodeO( 
int newGhostLen, 

char newGhcrfit£tring[256] T 
charRtr’ diet* 
ulongfii response) 

I 

// use recursive search for winning move 

response^ChooseOl(newGhostString*nevGhostLen t diet)S 

if (response) goto OK: 

//else 

// no winning move was found, so lei’s use a heuristic choice; 

//The preference is fur the shortest siring of even (odd ) length 
// which the opponent would have to make. But if all available 
// words are of the wrong length (I will have to make it)J chouse 
// a longer target word to increase the chances for the opponent 
// to make a mistake. 

charPtr 1 z = FindFirst{nGwGhostString h tiewGhosthen I *d Let.) : 
ul ong best Response J.2 j * 10,01: 
ulong ien*bestLen[2]; 

tm j>refer5hort^t h (nevGhostLen11); 

Adeline profcrLong (I prsforShort) 
bsstLeri [prsferLong] -0: 
bestLenIpreferShort]=100; 
response^): 
for(:;) i 

// get Mr si word which differs in the next letter 

do \ 

ulong. nextLetter^f^z) [nswGhostleu - 1]; 
if InexLLcLter > response) I 
responses ext Letter: 
ien=!>trLen4( *z) ; 
if (ien > nev/GhostLen) 
goto Try_This: 

I 

z++: 

if (z>=ti lc l+gNtJinWordn) 
break; 


PiayModeO 


Introducing... 


Funnel 

Web 
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Funnel Web's innovative design and 
powerful feature set helps make sense 
of complex Web sites by identifying 
key trends and events. 

Features 

• point and click interface 

• over 50 reports and graphs 

• up to 50 times faster than 
major competitors 

• platform independent 

• works with any web server 
on the planet 

Advanced Technology 

• Event Messaging 

• Remote Administration 

• Realtime Monitoring 


Intelligent Web Monitoring and Analysis 


Accuracy, speed, ease of use and powerful report-formatting 
capabilities, makes Funnel Web the perfect solution for 
monitoring e-commerce. Intranet and Internet sites. 

Backed by Active Concepts unrivalled 24 hour technical support. 


Download a free demo version at 

http://www.activeconcepts.com 

or visit our website to find out more 
about the Kilter Funnel Web Spider... 









// make sun* ir Is still the same word stem 

\ whilr^t^strnciiiptnewGhostString,* z . newGhostLen’ 1)): 
no_other_choice: 
break: 


char nevGhost[32]; 

Expand(nevGhost f newGhostString*newGhostLen *inse rt); 

nevGhofit finsert]=c; 

strcpy (newGhostSr r 1 ng T nevGhos t): 


Try_This: 

// record longest and shortest alternatives 

If ((lmt&l)""preferShort) | 

IF (len <- beatLenlprcferShort].) I 
bes L Lon[p t ef a rSho rt] 3 ien: 
bestResponse{preferShortJ=tespanee: 

) else ( 

if (len ) B bestlen[preferLong]1 [ 
beutLen[preferlong]=1en: 
bestResponEf? tpreferLoftg]=respoitse: 

I 

) 

] 


if (bestLtnfpreferShortl < 100) ( 
response-hostResponse f preferShort]; 
goto OK: 

I 

if (bestl^n[preferlang] > 0) ! 

response=bestResponseIpreferLongJ; 
goto OK: 

) 

// Bluffing Ls not allowed, so we have to give up 

return 0: 

OK: 

newChostStringInewGhostLen-1]-response; 
newGhostSt ring[newGhostLen]^0: 

return FindFirst (newGhos tSt ring. mswGhoat Lett .diet): 


PiayModel 

static charPtr* PlayModeU 
int newGhoatLen, 
char newGhngtString[2561 * 
ulong 6 response) 

// returns wordlnMind 

// mode 1 (add at beginning) can Ik* handled by mode Q logic 
// after all strinp ate reversed, 

if tnewGhostlen>2) 

ReverseString(newGhontSt ring, newGliostLen 1); 
charPtr* vordTnWind » 

P1ayModeG(nevChoatLen, newGhostString.glnverseDict.response >; 

if (wordlnMind) 

[ 

// have to reverse wordlnMind string and ghost string to normal 

char buffer[321: 

at repy(buff e r . * wo rd TnMi nd): 

int vordlon^strlen(buffer); 

ReverseString(buffer,wordLen): 
if (newGhostLenHj 

RevereeSt ring(newGhoatSt ring* neuGhostlen); 

// and then find actual word in proper dictionary 

vordlnMind-FfndFirst(buffer.wordLen,gDietWords): 

return wordlnMind: 

I 

return 0: 


Pf»yModc 23 

static charPtr* PlayHode23£ 
int newGhostLen* 
cha r newCho s t St ring [256], 
ulongt response) 

I 

// returns wordlnMind 

response=Chooae23(newGhostSt ring.nevGbostLen); 
if (response) I 

char ^response & OxFF: 
int insert=response»B; 


charPtr word InMnd-Shortest Word(newGhost.gGameType): 

// fmd the chosen wordJn_niind in the dictionary 

charPtr* dictWord-IsinDict(wordlnMind); 
return dictWord; 

I 

return 0: 


MakcRcport 

static int MakeReport( 
int ghcstLerw 

char newGhost£tring[256]. 
charPtr* wordlnMind. 

Int charPositions[256]) 

I 

// Returns wordinMimUndex for the actual word chosen 
// and computes diarPbsi Lions from the word, according to mode 
int wo rdLen-s t r1en {* wo rdInMind): 
switch (gGameType) t 
case addToEndOnly: 

for (int i=0:i<ghostLon;i++) 
eharPositions[i]-i; 
break: 

case addToBeginningOnly: 

for (int i”O;i<gh 0 stLen:i++) 

char Positions [il wordLen-ghost Lan+i; 
break; 

case addToBeglnningOrEnd: 

char' start=strstr f'wordlnMind,newGhostString); 
assert (start); 

for (int i“0;i<ghostLen:1 h-J 

charPositions [il“atart ■‘wordlnMind-}'1 : 

[ 

break; 

case addAnywhere: 

GotCharPositions( 

nevChostSt ring,ghostLen.* wordlnMind,charPositions}; 

return wordInMind-gDictWords: 

I 

Non static Functions “*“**“““**“‘7 


1 nitSuperDupcrGhost 


void InitSuperDuperGhost( 

const char 'die tUo rdsf], /* alphabeticalfy sorted uppercase dictionary words 


long aunDict i ana ryWord s f* number of mill-termmated words m dictionary V 

) l 

gMctWord&=dict Words; 
gMumWords^nuaDictionaryWords: 

ClearCachesO; 


void NewGhostGameC 
GameType iheGameType 

if (gGameType 1= theGameType) I 
gGameType^theGameType: 
choices^cache E theGameType]: 

if (gGameType — addToReginnlngOnly) 
MakelnverseDiclO ; 

else if (gGuueType > addToBeginningOnly) 

1 n it D i samb i gua t or (gDi c tWo r d &, gNuraWo rd s); 
I 
I 


NcwCrhosttlamc 


PlOTGhost 

void PlayGhost( 

const char * 1 * ghostString, I* die stnng so far. null-terminated */ 
char newGhoscSr ring [ 256 J, f* new ghostStnng. one letter added to glxwiSinng */ 
int * word InHind Index * /* ytmr string will match dxtWofdsI worrilnMindlndexl */ 
int charPositions[2561 

t index into diaWordsEwomllnMindlndcxI for each char in ncw'GhascString 7 


52 


Programmer's Chau.engi- 


MacTcch • January 2000 


















) I 

iat newGhostLen-strlen(ghostSt ring)+l; 
fitr^py(newGhostString*ghoststring): 
newGhostString[newGhostLenj*0; 
iharPrr* wardInMind=Q; 

if check cached choices for very short ghosts, 
ulong respoGse=0; 
if (newGhostiert<=2) [ 
if (newGhostLeo<2) 1 

wordlnMind^choices[0j .wordinMind; 
if (wordinMind) I 

re5ponse”choice£ f0].response; 
newGhostStrlngfO]“response: 
goto succeed; 

I 

I else ( 

wordlnMind^choicesUlfcghostStringEO]3 ■wordinMind; 
if {wordinMind) I 

res pons e^choices [3l&gtlOSt String [0] ] . response; 
if (response»8) I 

newGiiost SI r \ ng [I ] “response; // append 
I else [ 

newChostString [ 0 ]”response; ff insert 
nevGhostSt ring[11® ghost Strj ng f0]; 

I 

goto succeed: 

I 

I 


switch (gGaraeType) I 
case addToEtidOnly; 

wo r dInMind=PlayHod eO{ 

newGho s then,n ewGhostString*gD ic t Wo rd s* r esponso); 
if (wordTnHind) break; 
else goLo fail; 
case addTub e gi it n i n gOn 1 y: 

wordInHitid=FiayKodel (newGhosthen,newGhostString. response): 
If (wordinMind) break; 
elno goto fail; 


case addToBegitiningOrKnd: 
case addAnyvhere; 

wordlnM;nd=PlayMode23(newGhostLen.newUhostString,response); 
if (wordTnMind) break; 
else goto fall: 

I 

// remember choice in cache 
if (newGhostLen<=2) 1 
1f (newGhostLen<2)f 

choices[0].response^response: 
choices[0].wordlnMind*wordInKind: 

1 else I 

1 f {gGamely pe=a d d ToEtid Only) // fhup i nsc rt km pot tit 
response | = (K<8): 

choices[31kghostSt ring[0)1.re eponne^respnnse: 
choices [31£ighostString[0j J , wordlnHind“wordIrtM1 nd ; 

J 

1 

succeed: 

’wordinMindIndex-HakeReport(newGhoetLen* 
newGhostString * wordinMind * charPosiclous); 
return: 

tail: 

newChostStriug[0] w 0; 


TermSupcrl ittpt rGhust 

void Te rraSup e rDupe rGho st(void) 

I 

DeleteljiverseDict U : 

TerniDisasibiguatorf); 


Fight Boredom 

Let’s face it: Much of programming is boring 
and repetitive. Well, that’s where the right 
tool can save days, weeks, or even months 
of your valuable time. 



Model- View-Controller 

AppMaker’s generated code uses the MVC 
paradigm. It separates the user interface 
from application logic, making code easier 
to write. You deal only with abstract data: 
AppMaker takes care of the user interface. 


AppMaker 

Your Assistant Programmer 

AppMaker makes it faster and easier to make an 
application. lt J s like having your own assistant 
programmer. You point and click to tell 
AppMaker the results you want, then it 
generates “human, professional quality code” 
to implement your design. 


Scriptable Applications 

AppMaker generates the 'aete' resource and 
generates code to access your data 
(Properties and Elements in the Apple Event 
Object Model) and to handle Events, 

Just $199 from www.d6vdepot.com B*G*W*E*R*S 

Development 

PI). Box 929. Grantham. NH 03753 * (603) 863-0945 • FAX 863-3857 
bow e rsdc v @ aol ,cu m * h tt p: //me m be rs .ao J .c om/bowersde v 


Application 

Logic 















newdisambig-v2xp 

#include “ncwdisambig.h" 

Jinelude *myString,h" 

#define MDEBUG 
^include <assert,h> 

F* Function prototypes "7 

static ulong MakeSubDigestfCCC* xString T char sig[J); 

atatir. bool MaLcbFirstM (CCC* x.chac* findString,int jainLen, Int 

group): 

static bool Kutehi*LstN(UUC* x.char* fiodString*im ntaLenJm group}; 

static bool KatchMiddleNCCXIC*' x.char* fiodString,inr mSnUii,litl group): 

static bool KatchAnyN(CCC* x.char* find St ring, lot nioUen.int group): 

r Static allocations "7 

// charTihle serves double duty 

// in pursing it helps separate wild cards. 

// in digest forming, it provides a sort order 
static char cbarTable U2BJ = I 


0, 

0. 

0, 0. 

0, 0p 

0, 

0* 

0. 

0* 0, 

0, 

o, 

o. 

o, 0. 

0, 

0, 

Q, 0. 

0, 0. 

0. 

0. 

0, 

0, O, 

0. 

cu 

0. 

a, o, 

2, 

Op 

0, 0, 

0, 0, 

0, 

n T o. 

Or 0, 

0. 

0, 

0. 

o, 0, 

1. 

2. 

3, 4. 

5, 6, 

7, 

8, 

9. 

10, 0, 

0. 

0. 0, 

0, 0, 


0,25,12>19,18,28 JO, 16,13,2?, 4, /,20.14.23,21. 

15, 3.24.26.22.17, 9, 8, 5*11, 6, 0. 0, 0. 0* 1. 

0,25,12.ip,18i23,10,16,13,27, 4, 7.20,14,23,21, 

15, 3,24.26,22,1/, 9. S. 5,11, 6, 0. 0, 0, 0, 0 
I; 

typedei bo#l (‘StringMateh)(CCC* x.char* CindStringJut 
minLenJnt group); 
static StringMatch stringMaJ.ch[4] = l 
HatchFiratM, 

MatchlantN. 

MatcbNlddlefl, 

HaLdiAnyW 

I: 

//The table USB stores tlte position of the least 
// signillcani 1 1 bit in a byte (range I li> K). 

// a zero-byte reports 0. 

//This table is bn ill from nested ^defines 

//<!(> fine Tl 1 
//define T2 T1.2..T1 
//define T3 T2.3.T2 
//define T4 T3.4.T3 
//define T5 T'O.T'i 
//define TO T1.6.T5 
//define T7 T6.7.T6 
//define T8 T7.B.T7 
sialic dial LSBU56J-10.T8I: 
static CCC** gWordList; 
static ulong gNumWords; 

//define MINts.b) (a&b) 

// II/V5T] is just shoriband for charTkbk. 

//define HASHtc) (cliatTable |c]) 

struct Wortllndex 

//The class Wordlndcx liokis a pointer to a word from 
// wordlJst and computes dij*tsts and signature Tor it 

struct WordIndex I 
ulong digestI: 

CCC- ward: 

void Init(CCC* wordx) I 
CCC* wpn*iordx: 

Int s“liASll( *wp): 
along digl Jt lL<<s: 
tor (rJ I 
int c; 

if Hvp)} break; 

s-HASH(c); 
along hil“lL«s; 
dig! |" bit; 

digestl^digl; 
word^wordx; 

I 

void Getsignnturu(char* sig) [ 

// computes its signature, i.c amvem the digest to a string 
ulong digl~dlgestl>>l: 
char c“l; 
while (digl)I 
if (digl A 1) 

* s i g++**c; 

C++; digl »-U 

I 

*slg'0: 

return: 

I 


CCC* WordO [return wordj 

h 


struct Rage 

//The class huge hokk indices of 32 words in word list 
// whkh arc of the same length (words >= 31 together) 

// ftige a bo contains both word digests lor each word. 

// in the bits! | array, stored in signature oriented columns. 

// A page provides string matching for the 1 32 words it owns 
struct Paget 

CCC* word[32]; 
ulong fill; 

Page* next; 
ulong pageUigestl; 
ulong bitsf32j; 

void InitfPage* following) [ 

// dears all and sets linkage 

// memory may already lie precleared, but not necessarily 
// since pages may overlay the temporary word Index 

uGMiaet (this t 0,sizeof (Page)): 
next^foilowing; 

I 

int IsFullO I return (fill>-32):) 
void Add(Wordlnd&x* yip) ! 

//Adds one word to a page'. 

// ORs the word digests into the [/age digests. 

// Also ORs the horizontal hit slice representing word digests 
// into the hits array, 
char sig(64): 
ulong curbit~lL<<fill; 
word ffill+tl^ip-lHiord; 
psgeDignstl |= wEp >digc^Ll; 

wip->GetSignature(fiig): 
int c; 

char* sigp=sig; 
while (0 !-(c-’*sigp++)J | 
bitsicj |~ curbit; 

I 

ulong Match (char trig[]) 

// Accumulates vertical bit slices from a given signature 
// Returns a bit map of Ukeb candidate words 

I 

int c=sig[0l; 
ulong acc=bits[el; 

while ((ace) U (0 1= (c= K ++«ig))) ( 
ncc h= b3 ts[c]; 

I 

return ace: 

I 

CCC* GetFirstf 
StringMatch matchFun, 
ulong acc, 

char* findStrlng. 
int winhen, 

Ent group) 

( 

CCC" wp^word-1; 
do 1 

ulong accLo=acc 6 OxFF: 
if (acelo) | 

int j=t.SB[accLo] : 

acc.) >“5; 

wp+=j: 

il (matchFun( *wp.findString.ftrinLpn.group)) 
return *wp; 

J else I 
acc>>=8; 
wpi=8: 

I 

{ while (ace); 
return (J; 

I 

I; 


struct Page In dux 

//The daxs Page Indus contains a pointer to a page, and 
// keeps a copy of the page digest I 
// During the scan, I "age Index provides a screening function 
// to eliminate unnecessary page accesses if digest l can 
// alrcady r rule out all words on a page, 
struct Pagelndex i 
ulong digest:!; 

Page" page; 

ulong In ft(Page* thePage) I 
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digest1=thePage >pageOigesti; 

page^thePage; 

return thePage^fill : 

I 

Page* Screen(ulong findDigestl) t 

If [(findDigestl (findDigestl & digestl))) 
return 0; 
return page; 



struct Privatflka 

//Tlie daw PrivafeData is the main structure mapped into the 
// private memory spice allocated on the heap. 

//The pagcGfoup[] array holds pointers to linked lists of 

// pages, according to word length 

// Once all pages are assembled, the page addresses are remapped 

// into a linear page index, sorted by ascending word length 

//The IndexGroupliJ array points to the the first page of each 

// group of pages of a given word length t 

atatir struct PrivateData I 

// ftigc' next Page; overlay on unused pageGroup(O) 

//define next Page pageGroupfO) 

Page* pageCroup[32j: 

// Page Index' endOlPagdndex, overlay on indexGroup jO] 

//define endOfPagelndex indexGroup[0] 

Page! ndex * indexGroup [.32]; 
long BtorageSizo; 

Int bottomfl] j 

void In 11(CCC* wordLiatH .ulong numWords^iong 
minitmnaSLoriige) 

I 

gWordList^ordLIst; 

^MumUords-nuniWords: 
storageSi2e=minimumSrorage: 

WordTndex* vip; 

// Initialize word index 

Wordlndcx* wordTndexList=(WordIndex*)bottom: 
for (int n=0tn<iH3mWordn;n+4) 

wordlndexLiat [n] . I nit (gWor didst [n]) ; 

// Unload word index and build pages in linked lists 
// based on word length 

nextRage^fFage*)this + storageSize/sizeof(Page) 1; 
wip=vordIndexList+tmiftHords: 
while {wip>wordIndexLizt) t 
wip-: 


if (O^TnsertWordlnPagefwip)) 
return: 

I 

// Map linked lists to a linear index of pages by length 

if (0“BuiXdIndex(J) f 

next Page-HULL: // not enough storage 

return: 


int InuertWotdInPago(WordTndex* wip) t 
// Inserts one word in a page* opens a new page if 
// none exist* or if die current page is full 
int lnn“strien(wip->Word t}): 
if (len=0) return 1: //igtiomO-length words 
Pa go * pa ge=pa geGr oup fIen j: 

If ((page—fl) || (pago->IsFuil(JJ) 1 
Page* tetnp^page; 

page=nextPage-: 

// test if the bouom of die growing page array collides 
// with the top of Lite siirinking won! index array 
if (page O (FageOwip) I 
// nor enough storage, we have lo bail out 

next Fage=NlTLL; 
reiurri 0: 

1 

page’>lnlt(temp): 
pageGroup[ien]^page: 

1 

page-)Add(vfip): 
return 1; 

J 

PageXmJex* RuMdTndexO I 

// builds the page index, starring ai this->hotmm, 

// overwriting storage previously used by word index 

Pagelndex * pi=(PageIndex 1 J hot turn; 

PageIndex* piTop-(Pagelndex*)nexxPage: 
for (int Ien=I:Ien<32:len++] 1 
Page* page=pageGroup[lenj: 
indexQnjup [lenl-pi; 
int riuxKk 
while (page) [ 
if (pi>=piTop) 
return 0; 

nunt+=pi++- > I nit (page); 
page=page->next; 

1 

l 
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return (endOfPageTndex=pi): 

) 

CCC* GetShortestWordC 
char* fiudString, 
lilt mode) 

I 

// Hclurn the shortest word compatible w ith hndstrmg and mode 

char sigi64l: 

along findDigestl*itakeSublHgest (lindStrlng, sig); 

int minLsm®str 1 cn{findStririg) ; 

for (Int group^tnitiLen:group 02 ; group++) 

Pageindex 4 pi=indexGroup(group!: 

Pagelndex* endGroup* 

[groupOl HndGxGroup[group*l]lendOfFageIndex): 
for (;piCendGroupipi++) { 

Page* page-pi->Screen(findDigest 1); 
if (page) t 

ulong acc-page->Match{sig): 
if (acc) 1 

CCC* matchWord“page->GetFirst ( 
stringHatch(fflodeil]. 

arc, findString.minion *group): 

If (matehWord) 

return matchWord: 

I 

I 

) 

I 

return 0; 

I 

int GetShortestWatchest 
char* findString, 
int alnLen* 

Int mode* 
int shortestI2j) 

( 

// Linds rhe shortest word matching lindstring and mode, 

// Returns the length of this word, or 0 if none found 
// Only check words of even (odd) length 

char dig [64): 

ulcrng fIndDigeatI=MakeSubDigest(findSt ring, sigl: 
int step-I.numFound=0: 

for (int group-minLen:group<32;group+^step) 1 
Pagelndex* pi^indexGroup[group]: 

Pagelndex* endGroup* 

(groupO1?indexGrouptgroup+lj:end0f PageIndex); 
for (;pi<endGtc>up:pi++) f 

Page* page^pi ->Screetv( find Digest I); 
il (page) I 

uiorrg acc^page >Watch(aig); 
if (acc) I 

CCC* marr:h Word-page >GetFirst t 
nt ringHa tch[mode&3]* 

acc * finds t ring .lainLen, group}; 
if (matchWord) f 

shortest lnuraFound++Hgrciup; 

// return as soon as two matches arc Idund 

if (numFound >= 2) 
return mimFound; 

// If this was the first march in an even fixld) group, 

H we continue wirh the odd (even) groups only 1 , 
group-; 
step~2: 
break; 

I 

I 

J 

I 

I 

return numtound: 

\ 

I* PD; 

ft .external access functions (API) * 1,,u ' 


MtDisamhjguaior 

void lniiDisainbiguator{ 

CCC * wordList (], 
ulong numWords )I 
// Sets up the private data structure 
if (PD) //already done 
return: 


long word Yus':exSto r .nr; Wo id S ’ B i a eo1 ■ Wo rdindex); 

long pageStorc^(3l+numWorda/32) "sixeof (Page); 
long pagcIridexStore=pageStore * sizeof(Pagelndex) / 
sized(Page); 

long mininrumStorage^ 

sizeof{*PD) t 

(wordIndexStore>pageStoretpageIndcxStote? 
wordIndexStor e .; pageS Lore+page Index!)to re); 
PD=(FrivateData*) (new char [min imunSto rage J): 
memset (PD f Q .mlnittiumStorage}; 

PD >Tnit(wordList.numWords.minimuMStorage); 


ShortestMatches 

int ^number found*/ Shortest Hatches ( 

// Linds the shortest odd and even words matching findString 
// Returns only the lengths of the 0. Lor 2 words 

char * find String, 

Int lee, 

lilt mode, 

int shortest[2] 

) I 

assert(PD): 
int numFoiind^ 

PD->Get ShortestHaIdles(find String,len.mode,shortest); 
return mimFound; 


Short cstWord 

CCC* ShortestWord (char ‘fltidSt. ring, Int mode) 

return PD->Get5h{jrlestWord(findSrring.mode); 

J 


TermlMsamhrguator 

void TennDisambiguator(void) 

I 

if (PD) 

t 

delete [J PD:// was allocated with newt | 

PD=0; 

] 

J 

//**""* staijc Functions 


MatchFirstN 

sUlic bool HatchFirstNf 
CCC* x. 

char* findString, 
int tuinLen, 
int group) I 
tfpragma unused(group) 

// match of x against findStnng, first minUn letter* 

return (0=strnciHp(x*f IndString,minLen)); 

I 


Maichl^stN 

static bool MatchLastN( 

CCC* x, 

char* findSrring, 
int minion, 
int group) I 

// match of x againsi findSiruig, last minU‘n Ictlcrs 

return (0—stremptx+group minLen,findString)); 


MatchMxidlcN 

static bool MatchKiddleNf 
CCC’ x, 

char* findString, 
let minLen, 
int group) I 

// match of x against findString, any amst-fiiuvtr imnli-n Inters 

for (int d= , 0;d<=group minion;d++) I 
if (0=st rncmpfx+d, findsUing,minLen) J 
return true; 

) 

return false; 


MafdiAnyN 

static bool MatchAnyN( 

CCC* x, 

char* findString, 
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ini minLen, 
ini group) I 

// match of x against findString, any minLen letters in order 
tfpragma unused(group) 

for (int i*M); i<ttinLen; i++) ( 
char e-*f IndString: 
char d: 

while (0 I" (d“*x++n 1 
If {c^d) break; 

I 

if (d—0) 

return false: 
findStringtf: 

* 

return true; 


MitkeSuh Hipest 

static uiong HakeSubDigest[ 

CCC* xString. 
char sig[I) t 

// Creates a pair of word digests and a signalurt from 
// findString. No duplicate signature characters 

Hit s=HASJJ (String [Q]); 
along digestl~lL<<s: 
for (;;) t 
int c* 

if M-xString)) break: 

s w HASH(c); 
along bit“U-<<s; 
if (Ch^tdigestl & bit)) I 
digestl ]® bit; 

I 

I 

// Make the signature in bit order, that is with the 
// less frequent Rngiish letters first* so that page 
// scanning will fill as soon as possible if no word 
// in die page will match 

ulong hit1=2: 
along single^digestl; 
int s1; 

for Csl fe l;sK-2B:si-H-) 1 

if {single & bit!) *B-ig++“s1; 
bitl += bill; 

I 

*sig++-€: 
return digest!: 


MYSTRING.H 

#if defined Lcpluspius) 

extern "C w i 

faidif 

# i f rid e f KYSTRTNG_R 
^define HVSTR1NGJI 
typedef unsigned long ulong; 


StrCmp4 

inline long StrCmp4(const char* a.const char* b) 

// Fast comparator tor words of minimum length 4 

I 

const along* along*)(a): 

const uluug* wb={ulotig*) (b); 

ulong ca=*wa: 

ulong cb='wb; 

long d“ca-cb: 

if (d) return d: 

a+=l,b+-3: 

doff (s) 

f 

ca=*++a: 

cb^*++b; 

d=ca-cb: 

mm break;// wonts differ 


//if (ea=0) break;// words same, and NULL readied 

J while (c.a && (d=G>); 
return d; 


StrOnpN i 

inline long StrCmpR4(const char* a.const char* b,ulong n) 

// Fast comparator for words of minimum length L up to n letters 

I 

const ulong* wa-(ulong') (a): 

cons t U1ong* vb ~{U1ong *)(b); 

ulotig ca — *wa; 

along cb=*wb: 

long d-ca-cb: 

if (d) return d: 

ai=3 4 b+=3; 

for (int i=4;Kn;i++) 

I 

ca te *++a: 
cb-‘++b; 
d-ca-cb; 

if (d) break;// words differ 
i f (ca—0) break; // words sai ne, m id N ULL readied 

1 

return d; 


StrLcnd 

inline ulong StrienA (const char* w) 

I 

ulong len^; 

w+-l: 

while (*++*#) len++; 
return len; 

I 

//end 11 

Hf defined(_cnluspius) 

I 

tfendif G5Z3 
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TOOLS OF 
THE TRADE 


by Michael Ash 


Share Way IP Personal 3.0 


Enhancing AppleShare 
for the TCP/IP age 


Welcome 

As many of you may know, Apple’s 
new MacOS 9 ships with the ability to 
use Personal File Sharing over TCP/IP, 
Less widely known is that the 
technology behind this new feature is 
Share Way IP, from Open Door 
Networks, Inc:, Open Door has been 
selling Share Way IP for over two years, 
and Apple's inclusion of the product in 
the latest MacOS only serves to make it 
even more relevant. 

The concept behind Share Way IP is 
simple. It takes an existing AppleTalk- 
based AppleShare server, such as 
MaeOS's Personal File Sharing, and 
converts ii to work over TCP/IP as well 
Management of users and shared folders 
is kept on the original server; ShareWay 
IP is simply a gateway. This means that 
most configuration is kept exactly the 
same as before, making setup a very 
simple task, ShareWay IP also adds some 
important security features, an area 
where Personal File Sharing is very weak. 

Open Door Networks offers three 
versions of ShareWay IP: ShareWay IP 
Personal, ShareWay IP Standard, and 
ShareWay IP Professional. The Standard 
and Professional editions take an 
existing AppleTalk-based server on a 
separate computer and makes it work 
over TCP/IP. The Standard edition 


serves a single AppleShare server while the Professional 
edition can serve multiple servers. 

The Personal edition works only with an AppleShare 
server running on the same computer, and is aimed to get a 
typical Personal Pile Sharing setup converted over to TCP/IP. 
Since the Standard and Professional editions are used in only 
specialized circumstances, they are not covered in this 
review. When “ShareWay IP" is mentioned, it refers to the 
Personal edition. 


Why ShareWay IP? 

In almost any Mac network environment, AppleShare is 
the most convenient method of getting files from one 
computer to another. Simply go to the Chooser, log in to the 
other computer, and a nice shared folder appears right on the 
desktop. Shared folders act just like any other disk once 
connected. However, as networks expand to take on non-Mac 
platforms, the TCP/IP protocol becomes ever more prevalent. 
On many mixed networks, AppleTalk no longer works 
beyond the subnet in which it originates, 

Apple neatly solved this problem by adding TCP/IP 
capability to AppleShare, While the IP-capable version of the 
AppleShare client was free, the only way to run a server on a Mac 
was to spend several hundred dollars on AppleShare IP, Until Mac 
OS 9, Personal File Sharing was still relegated to AppleTalk. 

Fnter ShareWay JP, While AppleShare IP is a one-size-fit- 
all serving package, including FTP, HTTP, and mail, ShareWay 
IP concentrates solely on serving AppleShare via TCP/IP. The 
result is a small, easy-to-use package that gets the job done 
for a fraction of the price. 

First Impressions 

My first stop was Open Door Network's web site at 
<http://www.opendoof.com/> to download the trial version of 
ShareWay IP Personal 3.0. The one-megabyte download is a 
fully functional version of the program that will run for ten 
days. It is try-before-you-buy software, and makes for a 


Michael Ash is a junior majoring in Computer Science at the University of Wisconsin—Milwaukee. When he's not 
working with his Macs, you can often find him roHerhlading, playing chess, or grumbling about rhe cold. He can be 
reached at mai!@niikeashxom. 
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definite plus in mv book. The installer rook only seconds to 
run on both of my test machines. It didn’t even require a 
restart! Being an impatient person, I turned on file sharing 
and ran Share Way IP. I clicked the button labeled ‘‘Start," and 
a moment later was serving AppleShare over IP. The entire 
process took perhaps sixty seconds from starting the installer 
to having a running, functional server. 


1H ShareWay IP Status 


ShareWay is inactive 


Star 


Mo active connections 
IP Address: 1 29.89.177.168 


n Connected teLwii* 
” Users 


IP eddrew 




Target Server "Mr 6Q4e” 


Figure L Share Way IP about to be started. 


Once 1 had the server started up t I wandered over to my 
oilier test computer and logged in. For those of you not 
familiar with the procedure, it varies only slighily from 
lugging into a normal AppleShare server. Open the Chooser, 
dick AppleShare, but then instead of picking a server from 
the list, click the button titled “Server IP Address...” and type 
in the machine name or IP address of the server. After lhaL, 
the usual dialog box comes up asking whether to log in as a 
guest or as a registered user. Log in as normal, and the 
shared folder is mounted on the desktop without any 
AppleTalk at all. White this procedure is not unique to 
ShareWay IP. it is very nice to not have any extra hassle. 


thoaser 




AMUfcSiMfc*rnlnr W irifin 


Select a tile server 


Shared Computer 
Nero 


Enter the Server Address: 


1 appleshdre.sometomparty.com 


A 


Aliases made of this Server will fail if TCP/IP is 
not available. 


Cancel ] | | Connect 


G*yWnWt*r 1200 


Server IPAd dress 


OK 


J ApBieTa "' sssu 


76.2 


Figure 2. logging in to an AppleShare server over TCP/IP\ 


The ShareWay TP package comes with a program called 
“AFP Engage!” It serves as a partial replacement for Apple's 
Network browser program. Along with being a helper for 
afp:// URLs, it brings the convenience of the Chooser's 
AppleTalk server list to TCP/IP servers. It does this by using 
Service Location Protocol, an Internet standard for registering 
servers and a phtgin that comes with MacOS 8.5 and greater. 
Unfortunately, MaeOS 8,5 and 8.6 have version 1 of SLP, where 
MacOS 9 has version 2 These two versions are not compatible. 
However, copying MacGS 9's SLP plugin to an 8,6 machine 
will allow them to work together. I ran into problems getting 
this to work; it turned out that the Search Domains field in the 
TCP/IP control panel must be blank. Unfortunately, the issue 
is only mentioned in the Read Me for AFP Engage!, not in the 
main documentation. Once that issue was resolved, everything 
ran perfectly, but it's something to watch for, 

Setting it All Up 

Once ShareWay IP is up and running, there's little else to 
do in the way of setup Connection logs may be turned on if 
the administrator desires it. The server can also be run on a 
different port number, which may be necessary if the server 
is behind a firewall, AppleShare servers run standard on port 
548, which could present problems if a firewall or proxy 
blocks that port. With ShareWay IP, running on a nonstandard 
port is as simple as shutting the server down, selecting the 
appropriate menu item, and restarting it. Once this is 
accomplished, users will need to enter the new port number 
at the end of the server’s machine name or IP address using 
the standard notation of machine,name:<pnrt>. 

The only other configuration left is that of security, 
ShareWay IP allows guest access to be turned off, and also 
lias a list of users. This list can function either as an allowed 
list, where only those users on the list are allowed to log in, 
or as a disallowed list where the users on the list are unable 
to log on. Tills list is particularly useful, because it does not 
affect standard AppleTalk logins, allowing an administrator to 
limit worldwide access it? only those people who need it. 
Because of the nature of ShareWay IP, setting up individual 
users and their access rights falls to the underlying 
AppleShare server. 

If Lhc server has not been used as an AppleShare server 
before, then users, permissions, and shared folders must be 
set up using Apple's server software. Fortunately, Apple's 
experience in human interface design makes this process 
relatively painless. If an AppleShare server is already set up. 
then all of its settings transfer automatically and transparently 
to the ShareWay server. This is convenient, but it also means 
iliai the ShareWay server inherets any underlying limitations. 
In the case of Apple's Personal File Sharing, the main 
limitation is a maximum of ten simultaneous connections. 

Now the choice must be made as to which version of 
ShareWay IP to run. There are two, a normal application 
and a faceless background application. The faceless 
background app is difficult to quit accidentally and will 
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continue running if rite current user logs off under MacOS 
9\s Multiple Users feature, but it must be shut down to 
make any changes to the settings. The normal program 
can change settings without shutting down the server 
(with the exception of changing the port number) but 
could be easily shut down accidentally and won't function 
as a long-term server under Multiple Users. 

Documentation 

Open Door provides excellent documentation with 
Share Way IP, It comes in HTML form and is installed 
along wiLh the program, and can also be viewed on Open 
Door’s web site. The best part about the documentation is 
that it’s not necessary. Share Way IP is easy enough Lo 
figure out without the documentation, which is very 
pleasant. However, when a question arises or the user 
wishes to delve into the more complicated aspects of 
Share Way IP, the documentation is clearly written and 
very helpful. The only real problem is the aforementioned 
problem with AFP Engage!, where a pertinent issue was 
only mentioned in a Read Me. Otherwise, the 
documentation is very comprehensive. 

So, How’s the Speed? 

TCP/IP applications have always seemed faster than 
AppleTalk to me. AppleShare has no equal for 
convenience, but if the transfer of several hundred 
megabytes is called for, using FTP or a similar protocol 
seems to be the way to go. Does Share Way IP combine 
the best of both worlds? 

Son of. AppleShare is very CPLLspeed dependent; 
using a fast server will make for faster transfers. It would 
seem that a midrange 604e would be able to completely 
saturate a lOBase-T ethernet connection. Indeed, with a 
good web or FTP server it can, but performance suffers 
under File Sharing. My two test machines were a 
PowerCenter Pro {180MHz 604e) and an iBook (300MHz 
G3). Over AppleTalk, the PowerCenter Pro sustained 
roughly 370k/sec: as the server based on a 25-megabyte 
file on a XOBase-T network. The iBook managed 630k/sec 
when serving, a marked increase. Apparently Share Way IP 
makes the process even more dependent on the server’s 
speed. The PowerCenter Pro saw a large drop in speed 
when serving over TCP/IP, down to 215k/sec under 
otherwise identical circumstances. The iBook pulled off a 
small speed increase, jumping to 760k/sec. 

Unless the server is being run on a midrange G3, 
Share Way IP's performance may not be as great as one 
would expect. The speed on slower machines is adequate 
for casual use, but for heavy-duty serving, Share Way IP 
needs a reasonably fast machine. 


But, I Already Have Mac: OS 9*.. 

Ah hough built around the same technology, 
Share Way IP Personal 3 0 adds some features on top of 
the version that ships with Mac OS 9. The version that 
comes with Mac OS 9 is a faceless background application 
and can’t be configured beyond what's in the File Sharing 
control panel. The full version of Share Way IP Personal 
3-0 adds greater security and more options to the Mac OS 
9 version. As an added bonus, the $39 upgrade price from 
previous versions of Share Way IP applies to the Mac 1 OS 9 
version as well. Aside from being able to change the 
server’s port, the major extra features are security-ret a ted. 
Which brings us to,... 

Security 

Security is certainly not an area where Share Way IP is 
found lacking. With a live connection list and 
comprehensive logging capabilities, there is little left to 
be desired. Certainly security is one of the major 
improvements over the MacOS 9 version. 

The foreground application has a connection list 
similar to the one found in Apple's File Sharing control 
panel. The major difference is that Share Way's connection 
list shows the user’s IP address along with Ills name, 
invaluable information if the server is accessible to the 
outside world. 

More importantly, Share Way IP has the ability to keep 
logs of each connection. Though the log file is somewhat 
difficult to read, it provides a wealth of information. The 
user's name, IP address, time of connection, whether the 
attempt succeeded, how many bytes were transferred 
during the session, which, if any, errors AppleShare 
returned, and others. The information contained in the 
log file could be extremely helpful in the event of an 
unauthorized attempt to access die server. 

Conclusion 

For users still running versions of MacOS prior to 
MacOS 9, Share Way IP Personal 3-0 is a very important 
product. It allows Mac OS’s built in file sharing to run 
over a TCP/IP network with a minimum of cost and 
difficulty. Although not as comprehensive as AppleShare 
IP, it boasts a feature set more than sufficient for most 
situations. Under Mae OS 9, ShareWay IP Personal 3-0 
adds greater configurability and some important security 
features. While the version that comes with Mac OS 9 is 
sufficient for casual use, any serious servers could benefit 
from the added protection that ShareWay IP offers. 

ShareWay IP Personal 3-0 runs on any 68k or PowerPC 
Macintosh running System 7.5.5 or newer. It is available from 
Open Door Networks, Inc. for $79- Upgrades are available for 
users of Mac OS 9 and users of previous versions of ShareWay 
IP Personal for $39- Open Door Networks* web site is located 
at <http://www.opendoor.com/>, SSO 
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QUICKTIME 

TOOLKIT 


by Tim Monroe 


QuickTime 101 


Using Movie Controllers 
for QuickTime Movie 
Playback and Editing 


The Staie of the Aiit 

Its been almost ten years since Apple 
introduced QuickTime, its software 
architecture for creating and playing hack 
multimedia content* In that time, 
QuickTime has progressed from a Mac- 
only tool for playing movies roughly the 
size of postage stamps into the de facto 
standard on Macintosh and Windows 
computers for the creation, delivery, and 
playback of digital media, including video, 
sound, music, 3D graphics, virtual reality, 
sprite animation, and more. The range of 
abilities that QuickTime has gained over 
the years is Lruly staggering. It now 
supports real-time streaming of audio and 
video over the Internet anti LANs, a full- 
featured video effects and transitions 
architecture, vector drawing capabilities, 
and the ability to associate actions to 
sprites, text, hot spots in QuickTime VR 
movies, and 3D objects. 

It's high time, then, that MacTeeb 
should begin to devote some regular 
space to discussing QuickTime from a 
programmer's point of view, and this is 
the first of a series of articles that will 
focus on using the QuickTime application 
programming interfaces to create and play 
back digital media* Given the wide range 
of capabilities provided by the QuickTime 
APIs, you can guess that there will be no 


shortage of topics for us to investigate over the coming months 
and years. Admittedly, QuickTime can perhaps be a bit 
overwhelming if you try to understand it all at once. So we ll 
adopt a fairly leisurely approach and try to dissect the 
QuickTime architecture a little bit at a time, starting with its 
high-level interfaces and then gradually working down to lower- 
level capabilities to add to our knowledge of the entire 
architecture. Eventually, we'll be creating QuickTime files and 
writing custom QuickTime components just like the pros. 

In this article, well learn how to open and display 
QuickTime movies, and how to manage the user's interactions 
witli those movies (such as starting and pausing movies, zooming 
in and out in QuickTime VR movies, and similar operations). This 
is a relatively simple task, and it’s one that involves adding a 
fairly small amount of code to a basic working application. So, to 
really earn our money today, we’re going to complicate things. 
In addition to showing how to support basic movie playback and 
editing in a Macintosh application, we’re also going to show r how 
to do it in an application that runs on Microsoft Windows. In 
other words, we want the code we write here to compile and 
execute both on the Macintosh operating system and on the 
major flavors of the Windows operating system (to wit: Windows 
95, Windows 98, and Windows NT). 

Now this might sound like heresy, especially for a 
publication like MacTech whose mission is to report on and 
facilitate software development for Macintosh computers. But it's 
really just as consistent with MacTech Is mission as its regular 
coverage of the Interncl or of Java and other cross-platform 
languages and tools. Moreover, it's fair to say that die cross- 
platform parity exhibited by the QuickTime application 
programming interfaces since version 3-0 is largely responsible 
for QuickTime's recent explosion in popularity and is crucial for 
its continued success. So, everything we’re going to do in these 
articles will be completely cross-platform. 

In jxjint of fact, however, once you learn to pay attention to a 
few reclining issues like die endianness of multi-byte data, writing 
QuickTime code that is compatible with multiple platforms really 
Isn’t so hard. Indeed, part of the reason that Quickl ime runs .so well 


Tim Monroe <nionroe@apple.com> is a software engineer on Apple's QuickTime team. T te is currently developing sample 
code and utilities for I he QuickTime software development kit. 
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on Windows is that a good bit of the Macintosh programming 
concepts (including handles, resources, and file system 
specifications! were implemented on Windows us part of the 
QuickTime Media Layer. The hardest part of getting your QuickTime 
code to run on Windows may simply lie creating a basic application 
shell or framework to hold thnt code. Accordingly, we'll spend a 
good bit of time in tills article discussing just that issue. 

Mo vie Controllers 

Before we start looking at our source code, however, let’s 
take a minute to make dear what it is that we w'anr to achieve, 
for the moment, we ll be content to build an applic ation that can 
open and display QuickTime movies in windows on the screen. 
The Windows version of our basic application will have a "frame 
window" Thai contains a menu bar and within which we can 
open and display one or more movie windows. Figure 1 shows 
die appearance of the application's frame window before the 
user has opened any QuickTime movies. 



figure /, 71 k * frame tciruiow of the Windom a{pHcatum. 

A movie window will contain all the standard window 
parts (in particular, a title bar and close box), the movie 
itself, and a special set of controls called the movie controller 
bar. Figure 2 shows a typical Macintosh movie window. and 
Figure 3 shows a Windows version of the same movie 
window, both of these windows show the standard movie 
controller bar along the bottom edge of the window. 



Figure 2 L A movie window on the Macintosh. 




0 



Figure JL A movie window on Windows. 

The movie controller bar allows the user to control the 
playback of the movie and to navigate w ithin it. For instance, the 
user can use the fast-forward button to play the movie forward 
at an accelerated rate. Gr f the user can drag the position thumb 
to set the current location in the movie. 

Some kinds of QuickTime movies use a different movie 
controller bar. Tor instance, QuickTime VR movies are not 
typically played frame-by-frame in a linear fashion. For these 
movies, you'll see the movie controller bar shown in Figure 4, 
which contains controls that allow the user to zoom in and out 
and to perform other operations on the movie. 



Figure 4 The movie controller bar fora QuickTime VR movie . 

The movie controller bar is created and managed by a software 
component called a muine controller component (or, more briefly, a 
movie controllerl Now here’s die really fun part: once you’ve 
opened a QuickTime movie (using a few simple QuickTime 
functions), you can call a couple more functions to create and 
attach a movie controller to your movie. Thereafter, the movie 
controller (and not your application) draws the movie controller bar 
and manages all events associated with the movie. Your application 
doesn't need to know how to jump to a new location in the movie 
or how to start and stop the movie playback. It simply needs to pass 
any events it receives to the movie controller component before 
acting on them itself, lhe movie controller intercepts any events 
that apply to it and reacts to them appropriately. 
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So. the first lesson we need to take to heart is this: we 
can gel ail die basic movie playback capabilities simply by 
creating a movie controller, attaching it to our movie, and 
then giving it the first shot at handling any events we receive. 
And as if i hat weren’t enough, the movie controller also 
provides an extremely easy way for us Lo perform basic 
editing operations on movies that support diem. (Not all 
movies support cutting, copying, or pasting of movie 
segments; for instance, QuickTime VR movies do not.) 

The Application Framework 

Now it’s time for a hit of a detour As mentioned earlier, 
QuickTime provides an extensive set of services for handling 
digital media like sound, video, sprite animation, and the like. 
But of course we ll need to use other services to handle the basic 
graphical user interface for our QuickTime-savvy application 
(windows, menus, dialog Ixjxcs, and so forth). Since you’re an 
experienced Macintosh programmer, you're already familiar with 
the ideas underlying event-driven programming on the 
Macintosh. Kememixrr, though, that we want Lo support 
QuickTime programming on both Macintosh and Windows 
systems. So well need lo address separately the issues specific 
to each operating system, while trying to factor out as much 
code as possible to share between the two systems. 

Our general approach will go like this: well create two files, 
MacFramework.c and WinFrameworkc, that handle the basic 
application services that are specific to the Macintosh and 
Windows operating systems, respectively. These services include 
starting up and shutting down the application, handling events 
and messages, creating windows, owning files dropped onto the 
application icon, and so forth. We won't delve very much into 
these Framework files in this article, since there isn't very much in 
them of interest for QuickTime programmers. Suffice it to say that 
the Macintosh framework would look very familiar to anyone who 
cut their Mac programming eyeteeth on Mac lech f $ "Gening 
Started’* series {or on some similarly gtxxl .source); it uses standard 
event-driven programming techniques to handle the user's 
actions, And the Windows framework is a very straightforward 
implementation of die multiple document interface (MDI) 
specification defined by Microsoft for creating and managing one 
or more document windows within a general frame window. 

Whafs distinctive about MacFramework.c and 
WinFramework.c is that they have been carefully designed to ex 11 
functions defined in a third file, ComFrameworkc, lor most 
QuickTime services or other services that are not system- 
specific. ComFramewark + c also defines a number of functions that 
are substantially the same on both platforms but which may 
require several short platform-dependent blocks (introduced by 
the compiler flags TA R G ET_GS_M AC and TARGET_0$_WIN32 h 

Keep in mind that (in this article, at least) we want to support 
only the most basic playback and editing of QuickTime movies, 
which is exactly what is provided by the basic framework. In future 
articles, however, we'll want to add other capabilities m our 
applications. For instance, well want to handle some new' menus, 
in addition to the standard Fite and Kdit menus; and well want to 


perform some application-specific tasks aL idle rime (perhaps 
change the pan angle of a QuickTime VR movie). To make it easy 
to add such capabilities, we create yet another file, called 
ComApplication.c, which defines a number of functions that are 
called at particular times by die basic framework. For instance, after 
the framework does any necessary menu adjusting for the File and 
Edit menus (enabling certain menu items and disabling others), it 
calls the function QTApp_AdjustMenus 1 defined in ComApplication.c, 
to allow us to adjust any application-specific menus. Since we don l 
have any application-specific tasks to perform, for the moment at 
least, we can ignore ComApplication.c and instead turn our attention 
to the tile Com Frameworks. 

Handling Movie Windows 

To get a taste for how our basic framework works, let's 
liegin by considering how we want to manage our application's 
movie windows. On the Macintosh, a movie window is of type 
WindowPtf; on Windows, a movie window is of type HWND, To 
simplify the code that handles movie windows, we define a 
custom type that refers to either a Macintosh movie window or 
a Windows movie window, like ihis: 

tfif TARGKT_QS_MAC 

lypedef WtndowFtr WindowReterence: 

tferidif 

#if f tMUET_QS_WD02 

typedei HWND WindovRefernocf!; 

fandif 
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(*’rnyWIndowOb ject.).fAppData = NULL: 


We need to maintain some information for each movie 
window displayed by our application. We'll use the standard 
technique of defining a structure to hold this information and 
allocating an instance of that structure for each open movie 
window, lei's call this instance a "window object record". 


lypedef struct l 
WindowReEureticc 
Ho vie 

MovieCantroUer 

FSSpec 

short 

short 

Boolesn 

Boolean 

Boolean 

QTVRlnstatice 

GSType 

Handle 

I WindowObjectRecord, 


fWt rvdow; 
fMovie; 
fCoiit roller: 
fFiieFSSpec: 
fFileResID; 
fFileReffNum; 
fCanResizeWindov; 
fTsflirty; 
nsQTVMovie; 
finstance; 
fObjectType; 
fAppData: 

* WindowObj e c tPt r. * * Wind ovQb j act: 


Notice that the first field of this structure, IWindow. is of type 
WindowReference, which (as you've jusL seen) Is a WindowPtr on the 
Mac and an HWND on Windows. The fMovie and fController fields 
identify tile movie and movie controller The next three fields 
maintain information about ihe kx:aiion of the movie file on disk 
and in memory. The three fields after that indicate whether the 
movie window can be resized (which Ls almost always true), 
whether the movie data has c hanged since it was opened or last 
saved, and whether [lie movie is a QuickTime VR movie. If the 
movie is a QuickTime VR movie, the flnstance field holds the 
QTVR instance associated with the movie. The fObjectType field 
holds an arbitrary identifier ihai is unique to our application; we 
use this field just to make sure drat weVe got a valid window 
object Finally, the fAppData field holds a handle to any 
application-specific data. For now, we won t need to use this field. 

When the user selects a movie file to open, we need to 
allocate a window object record and attach it to the window in 
which the movie is opened. The standard Macintosh way to do 
this is to use the SelWRofCon function to set the window's 
reference constant, an application-specific 32-bit value, ro the 
handle to the window object record. Windows provides a similar 
capability to attach an application-specific 32-bit value to a 
window, will) the SetWindowLong function. Listing I shows the 
code we use for creating a window object. 

Listing 1: Creating a window object 

QTFraine t taatcWl 11 U 1 v wObjcct 

void QTPra rce_Crea t eWi nd owQb J ec t (WindowRn for oner* fhnWlndnw] 

I 

WindowObject myWindowObject = NULL; 

if (theWindow — NULL) 
return: 

// allocate spec for a window ohjm rrcord and fill in some of its fields 

rayWindavObject = 

(WindowQbject)NewHandleCIear(sizeoffWindowObj ec1Record)); 

if (myWindowQbject !- NULL) [ 

(**tnyWi ndowOb j ect). fVindow = theWindow; 

(> ndowObjeet), fControlleir « NULL: 

(‘ *rttytflndowObjerr 1. fObjectType = kMovieConttGlIerOhjeet; 

(*'rityWi ndowOb jeetj, fins tance * NULL: 

(* *tayWiridovObject), fCanResizeWindow = t rue: 

(* ‘tityWindowObject) ■ f IsDirty - false: 


I 

U assuring rnyVCindowObfcct (which may lx NULL) wilh llic window 

#lf TARGBTjQS_KAC 

SeiWRefCarKtheWindow, (long)rayWindowGfoject); 
leudif 

#if TARGET_0S_WIN32 

SetWindowLong(theWindow, GWLJjSEKUATA. 
(LfARAM)nr/WindowObject): 

ti associate a GrafPon w ith this window 

Gre3tePortAssor.iat:ion(theWindow t NULL, OL): 

U set the current port to the new window 

NacSetPort CU^TFraiiie^GetPortFrmiiWiudowRef ci once (theWI ndow)}; 


Internally, QuickTime does some of its drawing using 
QuickDraw, the collection of system software routines that 
perform graphic operations on the user’s screen (and elsewhere). 
And, as you know, QuickDraw does all of its drawing within the 
current graphics port. On the Macintosh, there is a very close 
connection between a WindowPtr and a graphics port, but there 
is no such connection between Windows HWNDs and graphics 
ports. So, when our application is running on Windows, we need 
to call the Create PortAssociation function to create a connection 
between the HWND and a graphics pun (of type GrafPtr), 

Once we've called Create Port Association to associate a 
graphics port with an HWND. we can subsequently call the 
GetNativeWindowPort function to get a pointer to the graphics 
port that was associated with that window. Listing 2 defines a 
function that we can call from either Macintosh or Windows 
code to get a window's graphics port. (Now you can understand 
the last line in Listing 1, which sets the current graphics port to 
the port associated with the specified window.) 

listing 2: Getting the graphics port associated with a 
window 

QTFiimi: Gu Pur 1 1 min WmduwRdcrence 

GrafPtr QTFramc_GetPortFroroWindowReference {WindowReference 
theWindcw) 

I 

Hf TARG£T_03_MAC 

return{EGrafFtrjGetWindowPort(tbeWindow)); 
fendif 

H f TARGET QS_tfIM3 2 

return(GetNariveWindowPort LtheWindov)); 

#endif 

I 


Let's look briefly at a IVw other small utilities that we ll use 
extensively in our framework code. Keep in mind that our general 
goal here Ls to provide utilities that insulate us from the specific 
details of any particular operating system. One tiling we'll need to 
do fairly often is retrieve the window-specific data that we've 
stored in the window object record ass<x:iaLed wadi a given movie 
window. We can use the GTFrame GetWindowObjectFromWindow 
function, defined in Listing 3 to do this. Aside from a few sanity 
checks (namely the calls to GTFrame_lsAppWindow and 
GTFrame_lsWindowObjectOurs), this function Ls essentially the 
reverse of attaching the window' object record to a window. 
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Listing 3: Getting the window-specific data associated 
with a window 

Q'lTrame_GetWindowObjectlTomWindow 

WindowObject QTFrame GetWindowObjectFromWindow (WindowReference 
theWindow) 

{ 

WindowObject myWindowObject = NULL; 

if (!QTFrame_IsAppWindow(theWindow)) 
return(NULL); 

#if TARGET OS MAC 

myWindowObject = (WindowObject)GetWRefCon(theWindow); 

/fend if 

/fif TARGET_OS_WIN3 2 

myWindowObject = (WindowObject)GetWindowLong(theWindow, 
GWL_USERDATA); 

/fend if 

// make sure this is a window object 

if (!QTFrame_IsWindowObjectOurs(myWindowObject)) 
return(NULL); 

return(myWindowObject); 

1 


Finally, well often need to iterate through all open movie 
windows. On Windows, this is fairly simple, since the operating 
system provides an easy way for us to ask just for the first (or 
next) child of the MDI frame window, which we know to be a 
movie window. On the Macintosh, it’s a bit harder, since we need 
to skip over any dialog windows or other types of windows that 
might be in our window list. We can use the functions 
QTFrame_GetFrontAppWindow and QTFrame_GetNextAppWindow, 
defined in Listings 4 and 5, to step through all open windows that 
belong to our application. 


Listing 4: Getting the first application window 

QTFrame_CictFrontAppWindow 

WindowReference QTFrame_GetFrontAppWindow (void) 

{ 

//if TARGET_OS_MAC 

return(FrontWindow()); 

/fend if 

//if TARGET_0S_WIN32 

return(GetWindow(ghWnd. GWJIWNDFIRST)); 

/fend if 
) 

One thing to notice in Listing 5 is that we did not find the 
next window by reading the nextWindow field of the window 
record, as used to be standard practice. Instead, we’ve used the 
accessor function GetNextWindow defined in the header file 
MacWindows.h. Here we’re treating the window record as an 
opaque data structure and thereby facilitating our eventual move 
to Carbon-compatible APIs. 


Listing 5: Getting the next application window 

QTFrame_GetNextAppWindow 

WindowReference QTFrame_GetNextAppWindow (WindowReference 
theWindow) 

{ 

//if TARGET_OS_MAC 

return(theWindow = NULL ? NULL : 

GetNextWindow(theWindow)); 

/fend if 

/fif TARGET_0S_WIN32 

return(GetWindow(theWindow, GW_HWNDNEXT)); 

/fend if 
} 


To find the front movie window, on the Macintosh, well just 
walk through the window list until we find the first window with 
a non-NULL window object attached to it, as shown in Listing 6. 

Listing 6: Getting the first movie window 

QTFrame JietFrontMovieWindow 

WindowReference QTFrame GetFrontMovieWindow (void) 

{ 

WindowReference myWindow; 

/fif TARGET_OS_MAC 

myWindow = QTFrame_GetFrontAppWindow(); 
while ((myWindow != NULL) && 

(QTFrame. GetWindowObjectFromWindow(myWindow) == NULL)) 
myWindow = QTFrame_Get.Next.AppWindow(myWindow); 

/fend if 

/fif TARGET_0S_WIN3 2 

myWindow = (HWND)SendMessage(ghWndMDIClient, 

WM_MDIGETACTIVE, 0, 0L); 

/fendif 

return(myWindow); 

) 

And to get the movie window that follows a specific movie 
window, well continue walking through the window list until 
we find the next window with a non-NULL window object, as 
shown in Listing 7. 

Listing 7: Getting the next movie window 

QTFramc_GctNcxtMovieWindow 

WindowReference QTFrame_GetNextMovieWindow (WindowReference 
theWindow) 

( 

WindowReference myWindow; 

/fif TARGET OS. MAC 

myWindow = QTFrame_GetNext.AppWindow(theWindow) ; 
while ((myWindow != NULL) && 
(QTFrame_GetWindowObjectFromWindow(myWindow) — NULL)) 
myWindow = QTFrarae_GetNextAppWindow(myWindow); 

/fendif 

//if TARGET OS WIN32 

myWindow = Get.Window(theWindow, GW_HWNDNEXT) ; 

/fendif 

return(myWindow); 

) 


Handling Menus 

Now we want to do the same thing for menus that we’ve 
done for windows, namely develop a unified way to refer to 
menus and menu items, so that we can (for instance) enable and 
disable menu items, or process the user’s selection of menu 
items, in a platform-neutral manner. Happily, this is a simpler 
task than the one we just solved. 

On the Macintosh, a particular menu item is specified using 
two pieces of information, the menu ID and the index of the 
item in the specified menu. On Windows, a menu item is 
specified by a single 16-bit “menu item identifier”, which is an 
arbitrary value that we associate with the menu item. Because 
the value on Windows is arbitrary, well construct it by setting 
the high-order 8 bits to the Macintosh menu ID and the low- 
order 8-bits to the index of the menu item in the menu. 
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Suppose wc use the following values for our resource and 
menu IDs in our Macintosh resource hie: 


//define kHttnuBarResID 
//define k A p p 1 eMemiRes ID 
#ii e r i ne k F i 1 eM g mjResID 
kEdiLMGriuResJD 


define lD£J_FiLEHENlI 
//define IDM.FILENEW 
//define IDM_FILE0PEN 
// define I DM FILE CLOSE 
//define TDM FTLESAVE 
//do FI ne TDM_FTLESAVEAS 
//dofine IDFLEXIT 

//define IDS„EJ}ITKENU 
define IDM_EDITUWDO 
define IDM EDITQJT 
//define IDM EDITCOPY 
//define TDM EDITFASTE 
^define TDM_EDTTCLEAR 
^define IJJfi^EU ITS ELECT ALL 


123 

123 

m 

no 


item identifiers like this: 

33024 // (kRk , MtnuReslD«H)+0 
33023 // (kFileMeniiResm«ii)41 

33026 

33027 
33023 
33029 
33031 

33280 //(kM[MenuR^[[>«HHO 
33201 //1 kFditMrniiRttd IK<H}+1 

33203 

33204 

33285 

33286 
33288 


Then we can define our menu 


You might he wondering why we didn't just define, for 
instance, IDS_FiLEMENU as (kFileMenuResID«8)+0, In fact this 
works fine when developing either Mac or Windows applications 
using Code Warrior, but it doesn’t seem to work when using 
Microsoft Developer Studio on Windows machines. Go figure 
(literally!). Also, for those of you with calculators that don’t have a 
key, bit-shifting left by 8 is the same as multiplying by 256 i. 
In effect, we’re simply adopting die Windows method of 
specifying menu items, but doing so in a manner that allows us 
to retrieve the Macintosh menu ID and menu item index from 
the arbitrary menu item identifier, using these macros: 

//define MENa_ID£NTIFlERtinehulD*(fienul ten) 

(UenuID<<8) + (mem]Item)) 

//define MENU ID (menuldentlfier) 

((memildentifler&OxffOG)>>8) 

//define MENU„ I T1H[ menu Identifier) 

[ {mermldentIf [ er&OxOOff)) 


Now we need to devise a way of referring to menus 
themselves in a cross-platform way. On die Macintosh, we access 
menus using variables and parameters of type MenuHandle. while 
on Windows, we use variables and parameters of type HMENU, 
Once again, well define a custom type that refers to eicher a 
Macintosh menu or a Windows menu, like this: 

//if TARGET_0S._MAC 

Lypedef MenuHandle MenuReference; 

//endif 

if if TAK6ETjOS_WIN3 ? 

typedef HMENU HenuReference: 

//end if 


Let’s see how r tills all fiLs together in practice. Suppose we want 
to enable or disable a particular menu item For instance, the user 
may have edited a movie window, in which case we want to make 
sure tint tiie Undo menu item in the Edit menu is enabled Wb can 
use the function GTFrame_ SetMenu Item State defined in Listing 8. 


Listing 8: Enabling or disabling a menu item 

QTFm mcjkl Men uTre mSiaic 

void QTFra®e_SetHenuItemState (MenuReference theMenu. Ulntlfe 
theMe mil tern, short theState) 

I 

//if TARGETjOS_KAC 

if [theState ** kEnableMenultotn) 

EnableMemiIteia(theMemj, HENU_ITEH{theMenuIt(?m)S; 
el se 

Disab 1 eMenuIrem{theMenu, MENU ITEMCtheHenuItera)); 

#endi£ 

#11 TARCET_0S_W IN3 2 

Enable Me mi I rein (the Menu, tLFiNT) LhcMenuItera, [HINT) theState): 
tfendif 
I 


On Windows, QTFrame_SetMenultemState uses the 
Windows function Enable Menu Item to set the specified menu 
item to the desired state. On the Macintosh, it calls eiLher of the 
two Macintosh functions Enable Menu I tern or DisableMenuitem. 
depending on the value of theState 

QuickTime Support 

Now let’s geL back to the task at hand, which is showing 
how to open and display QuickTime movies, and how to handle 
basic editing operations on those movies. 

Opening a Movie Fife 

Let’s suppose that you’ve already got a file system 
specification record that indicates which movie file the user 
wants to open. You might have called the Standard File Package 
or (on Macintosh) the newer Navigation Services to elicit a file 
from the user, or you might have gotLen the file specification 
from an Open Document Apple Event. At this point, you can call 
the function Open Movie File to open the movie file: 

utyErr * GpenMovieFileUrcyFSSpec. iiayRefNura, fsRdWrFerm); 

NexL you need to load the movie data from the file. You can 
do tills by calling the NewMovieFromRIe function, as follows: 

niyResID = 0; 

my Err " NGwHovieFromFiletirnyMovie, myRefNum. taiyKesMl. NULL, 
newMoyicActi vr, NULL); 


Now you need to create a window in which to display the 
movie. This operation is platform-specific: on the Macintosh, 
you can call the NewCWindow function, or on Windows you can 
call the CreateWindowEx function. Once you’ve successfully 
created a window, you just need to pass that window to the 
QTFrame CreateWindowObject function defined in Listing 1, 
which (as you saw) allocates some memory to hold information 
needed by our frameworks and attaches the window object 
record to the w indow'. 

Attaching a Movie Controller 

So, at this point, we T ve opened the movie file and read the 
movie data from it. We've also created a window (which is not 
yet visible), created a window object, and attached the window 
object to die window. Before we can make the movie window 
visible, we need to create a movie controller and attach it to the 
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window* We do this by calling the framework function 

QTFr ame_ SetupC o n trol ler: 

royMC " QTFrame_SetupCoiitroller[iiiyMovle F tnyWindov, true); 

The QTFrame_SetupControlfer function is a tad lengthy, so 
we won't show it all here. But it does only four things of any 
real interest: it creates a new movie controller for the specified 
movie, it enables movie controller editing, it adds a grow box to 
the movie controller bar, and it installs a movie controller action 
filter function. We’ll discuss movie editing a little later; for now, 
let's see how ro do the other three tasks. 

Before you can create a movie controller, you need to 
determine the rectangle within which the movie is going to lx* 
displayed. Our basic application draws the movie at its natural 
size, which we can obtain by calling the GetMovieBox function 
( making sure that die top-left corner of the movie is at 0,0): 

GetMovieBox(myHovie, &myRec l); 

Mae Of f setRee t (kmyRee t, royRec t. left * -ntyRect* top); 
$elMuvieikjx(myM.ovie, kmyReeti : 

Then we can create a movie controller widi this single line 
of code: 

myMC _ NewHovieContrgXler(usyMovie. imyRect* rocTopLeftMovie); 

Even though we've opened the move at its natural size, we'd 
like to allow the user to resize the movie window. By default, the 
movie controller does noi provide this capability, so we need to 
do a little w r ork to enable movie resizing. The first tiling we need 
to do is find the upper bounds for the movie window size, in 
other words, we need to find the largest rectangle that can 
contain a movie window. We could set an arbitrary upper bounds 
for our movie window size, but instead we’ll allow the user to 
resize a movie to fit as much of the available screen space as 
possible* On the Macintosh, we can gel this area like this: 

gMCResizeBounds = ("GprGrayRgnO). rgnBBox; 

(This line of code isn’t Carbon-compliant, of course. We still 
have a little bit of wor k to do before our Macintosh framework 
is fully Carbonized.) On Windows, we can call the 
GetDesktopWindow and GetWindowRect functions to get the size 
of the desktop Note that GetWindowRect returns a structure of 
type RECT t which on Windows consists of four long integers. So 
we need U) convert the RECT into a Reel, like this: 

RECT myRect ; 

GetWindowRect(CetDesktopWindowO * SmyRect); 

OffsetRect(fcmyRect, -myRect* left* -royRect.top); 
gMCResizeBoartds.top = tshort)myRect, top; 
gMCResizeBounds.left - (short)myRect-left; 
gMCRefilze&Diinds.right - {shorLJmyRect*right: 
gMCResizeBcHinds.bult.oiii = (short) royRect. bottom: 

'iTien, we can enable window resizing by calling the 
MC Do Action function with the mcActionSetGrowBox Bounds 
parameter: 

MCDoAct i on (myMC, me Act ionSc t GrowBoxBounds, RgMCRes i zeHouttd s) ; 


MC Do Action is a general-purpose tool for getting a movie 
controller to perform various actions. (If you lake a look in the 
header file Movies, h, you'll see well over 60 defined movie 
controller actions.) We’ll use MCDoAction extensively throughout 
this series of articles. For the moment, though, it's important to 
know dial before the movie controller performs any action 
initiated by MCDoAction, it informs your application of the 
pending action and indeed allows your application to cancel that 
action. Tv get these notifications of pending actions, you need 
to install a movie controller action filter function, like this: 

MCSetActionF i1fcerWithRefCon[wyKC, 

NewMCArt.ionFi 1 terWi thRefConProc (QTApp_MCActioriFiiterProc), 

(long)myWindowObject); 

The first parameter is the movie controller lo which you want 
to attach a filter function. The second parameter is a universal 
procedure pointer for the filter function itself. Die third parameter 
is an application-specific reference constant that is passed to the 
filter function whenever it is called. As you can see, we're passing 
die window object lo die filter function so that we can gain access 
to die movie window's data inside that function. 

Listing 9 shows a typical movie controller action filler 
function. This function handles only one action, 
mcActionControllerSizeChanged, which the movie controller 
sends to our filter function whenever the user lias dragged 
the resize box in the controller bar. Our job is then to resize 
the associated movie window. 

Listing^: intercepting movie controller actions _ 

QTFramc SctMcnuflemScttc 

PASCAL_RTN Boolean GTApp MCActionFilterProc (MovieConlroller 
theHC, short theAction. void •theFarams. long theRefCon) 

I 

//pragma unused(theHC, t he P&rants) 

Boolean isHandled = false: 

WindowObject myWindowObject = NOLL: 

myWindowObject - (WindovGhject)theRefCon; 
if (royWindovObjert — NULL) 
returnUsHandled); 

switch (theAction) \ 
ft handle window resizing 
case meActionControllerSizeChanged: 

QTFr ame_SizeWindowToMovie(myVin 6 ouObject); 
break; 

default: 
break; 

\ ft switch (thcAoion) 
return(isHandled): 

A movie controller action filter function should return false as 
its function result if it wants the movie controller to handle the 
action specified by the theAction parameter. Conversely, it should 
return true if it doesn't want the movie controller to handle the 
action. In the case of the mcActionControllerSizeChanged action, we 
return false to lei the controller do any processing it needs to* 
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Handling Events 

Once we’ve goi a movie file opened in a window and liave 
attached a movie controller to it T we need to let the movie controller 
handle any events that apply to it. (For instance, if rhe user hits the 
space bar, the movie controller should sum or stop the movie, 
depending on its current playing state.) The main thing we need to 
do is pass the event to the MClsPlayerEvent function, hut how we 
do this differs between the Mac and Windows platforms. 

On Macintosh, we get events in our main event loop by 
calling WaitNextEvent. When we retrieve an event in this way, we 
don't know which, if any, movie controller ii rnighi apply to. So, 
well just pass the event to all open movie controllers until we 
find tine that accepts it Listing 10 shows how we do this. 

Listing 10: Handling events on the Macintosh 

QTFra me_Qiecfc MovirQmtrolltrrs 

static Boolean QTFrame_CheckMovieControllers (EventRecord 
*tbeEvent) 

I 

WlndowPrr myWindow; 

WimlowQbjec l oiyWIndowObject; 

MovieController rnyHC; 

raytfiTidov - QTFcame GetFrontHovieWindow(): 

while (myWindow !- NULL) t 

myWindowObject = OTFrame .GetWindowObjectFrcn^iridow[rayWirKlow); 

if (ray tf 1ndnwOb Jec.t 3- NULL) t 

myMC " f*‘rayWindowObject).fController: 
if (nyMC 1= NULL) 

if (MClsPlayerEvent (myHC. theEvent)) 
return(true)♦ 

1 


rayWindow - QTFranie^GetNextMav 1 eWi ndow(oiyWindow ): 

I 

return(false): 

I 

On Windows, however, system and user actions arc handled 
somewhat differently, Windows sends messages describing those 
actions directly to die window procedure of the target window, 
so we know in advance which movie controller the action might 
apply to. The only “gotcha" is that MClsPlayerEvent wants to get 
Macintosh sLylc events, not Windows-style messages. So, we 
need to call the function WinEventToMacEvent to translate the 
Windows message into a Macintosh event, as shown in Listing 1L 

Listing 11: Handling events on Windows 

Q'nrdmOluvieWndPm 

WinEventToMacEvent [ArayMsg, &myHacEvent); 

// pass the Mac event to rhe movie controller if the muvie window isn’t minimized 

If (IIsiconic(theWnd)) 

MClsPlayerEvent EmyMC. (Event Record *} ^ jit y Mac Event); 


Editing a Movie 

Some QuickTime movie controllers support the typical cut, 
copy, paste, and dear editing operations through a handful of 
high-level functions that are very easy to use. By default, a 
newly-created movie controller has editing turned off. so we 
need to explicitly turn it on, like this: 

MCEnableEdiling (myHC, true) ; 
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If you’re interested in finding out whether a particular movie 
controller supports editing, you can inspect the value returned by 
MCEnableEditing, which is non-zero if die specified movie controller 
does nor support editing. Well ignore that return value hem, since 
we ll dynamically determine whether a movie controller supports 
editing whenever we adjust our applications menus. 

When the user selects an item in our Edit menu (or performs 
some equivalent keyboard operation J, we simply need to call the 
corresponding movie controller function. For instance, if the user 
selects the Cut menu item, we’ll call die MCCut function and also 
set a flag to indicate that the movie’s data lias changed; 

myMovle m MCCut (niyMC): 

{ 1 'ttyWindowGbjectJ t ±IsDirty = true; 


MCCut removes the current movie selection from the 
movie associated with the specified movie controller. 
Moreover, MCCut returns the cut movie selection to us: this is 
useful if we want to allow the user to paste that segment hack 
into the same movie (or indeed into some other movie). We 
need to call the PutMovieOnSerap function if we want to allow 
that segment to be pasted. Listing 12 shows our entire function 
for handling the Edit menu. 


lasting 12: Handling items in the Edit menu 

QTFnimt: I h ndteMt Mtn u I ton 

void QTFrameJiandleEditMenuItem (WindowReference theWindow, 
Ulntl6 theMenuItem) 

I 

WlndowObject BiyWIuduwObject - NULL; 

MovloConlroller myMC * NULL; 

Movie myMovie = MULL; 

myWindowObject - QTFrama GctWindowOhjeotFroisiWindowO iLoWitidow); 
myMC - QTFrame GetMCFroinWindov( rheVi ndow}: 

// make sure wc have a valid movie controller and a valid window object 

i f ((rayMC = NULL! | j fwyWindowObjsct — NULL]) 
return: 

switch (theMenuItem) t 
case IDODITUNDO: 

MCUndo £myMC}: 

(••myWindowObject),flsRlrty = true: break; 
cane TDW_R[)JTCUT: 

rayMovle *■ NCCui(nyHC): 

(••myWindowObject).flsDirty - true: break; 
case 1DMJSDITC0FY: 

rayMovie * MCCopy(myHC): break; 

case IDM_EDITPA5TE: 

MCPaste (myMC, Nlfr.L); 

(**ffiyWIhdowObject), flsDlr ty = true; break; 

case TDM_RDITGLBAR: 

WCClear(myMC); 

(**niyWindcwObject) ,f!sDirty = true; break; 
case 1DM_E D1TSELECTALL: 

QTUtils_SelectAilMovie froyMC); break; 

default: break; 

I // switch (iheMeniiltcm) 

// plait* any cut or copied movie segment onto ibe global scrap 
If (feyHovie I" NULL) I 

FutMovieOnS c ra p(myMovie. OL); 

DisposeMovie(myMovie); 

I 

1 


The movie controller also provides an easy way lor us to 
determine which Edit menu items need to be enabled or 


disabled aL any time. The function MCGetControllerlnfo returns a 
32-bit set of flags that we can inspect to see the current status of 
the movie controller, such as whether the user has edited the 
movie. So, to enable or disable the Undo menu command, we 
can use code like this; 

MCGetContro31erTnfo£wyMC, Flags); 
if (myFlags & mcInfoUndoAvailablc) 

QTF ra me_Se l Menu1L emS t ate(myHe nu, 1DMJZDTTUNDO, 
kEnableMenuItem); 

else 

QTF ratne_S e t Menu 11 entS t a t e (ray Menu, I DM FDT TUNDQ, 
kDisableMenuItem); 

See the function GTFrame AdjustMenus in ComFramework c for 
the complete .story on adjusting all the Edit (and File) menu items. 

Conclusion 

Well, we’ve accomplished what wc set out to do, namely 
show how to open Quickl ime movie files in movie windows and 
handle user interactions with those movies. Along the way, we also 
took a fairly long look at some of the techniques we can use, here 
and in the future, to make sure 1 that our code operates identically 
on toth Macintosh and Windows operating systems. By spending 
the time now getting to understand how to use the platform- 
independent utilities defined in ComFrameworkc, wc lutve (1 hope) 
made it easier for us to spend our time later focussing on the 
QuickTime-specific tasks we warn to accomplish. 

Before we dose up shop, let's take a minute to discuss the 
source code that accompanies this month's article. 1 have 
included ihree project files created with Merrowerk's 
CodeWanrior IDE version TO.2. These projects build PowerPC, 
(>8K, and Windows versions of an application called QTShell, 
which is our bare-tones QuickTime viewing and editing 
application. 1 have also included the file QTShell.mak, which you 
can use with Microsoft Developer Studio to build a Windows 
application, if you prefer programming on a Windows machine. 
(The CodcWarrior project files should also work when using 
CodeWarrior on Windows, but l have not tested this.) 

No matter which platfomi or development environment you 
develop on, you’ll need to obtain the QuickTime-specific header 
files, libraries, and (on Windows) resource-building tcx>ls. These 
are available on the QuickTime Software Development Kit (SDK) 
CD, which I highly recommend if you really want to do some 
serious QuickTime programming. The same header files, libraries, 
and tools are found on the CD included in the excellent book 
Discovering QuickTime by George Towner (available through die 
Developer Depot at http://www.devdepOTxom). Finally, you can 
download the necessary files from the QuickTime web site at 
hup://www,apple.com/quicktjme/developefs. 

Credits 

The basic Windows framework for the QTShell source code 
(as contained in the file WinFramework.c) is based on an earlier 
sample code package by Brian Priedkin, called MD) Player, The 
basic Macintosh framework (as contained in the file 
MacFrameworkc) and the factoring of any application-specific 
code into the file ComAppliction.c is based on an earlier sample 
code package by Kent Sandvik, called MovieShell. (Sil 
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Contributing Editor, Michael Swan 


Network Programming under (Mk)Linux 


How programs 
communicate through 
sockets in a client-server 
architecture 


My first personal computer was a Mac 
Ilsi and I've always had a Mac for fun and 
personal use, but, as a programmer, 1 was 
born in a UNIX environment and there f 
grew up for my job. In particular, I spent 
lot of time implementing network 
protocols ant! writing software lor client- 
server architectures. When I heard, near 
two years ago, that there was a Linux 
implementation for PPC t couldn’t resist 
and I cleared a little space on my hard disk 
to install it and try it. 

1 here Ls a lot of talk nowadays about 
Mat: OS X, Linux and its Macintosh 
incarnations, Darwin, OpcnSouite, 
networking technologies, and you've seen it 
in the pages of MacTech Magazine t<xe So t 
if you are just curious, or you plan to write 
networking code in a UNIX-like 
environment maybe this article can give you 
some stalling points and/or some !lints. 

Background 

in this article I assume that you have 
a working UNIX-like environment and 
some familiarity with it. If this Is not your 
case don't worry! There are lots of 
resources on the net to help you fulfill 
these requirements. A good starting point 
could be the official site of the MkLinux 


community: http://www.rnklinux.org. This site can help you choose 
the righi Linux flavor for your machine (PPC or 68 K. PCI or 
Nulkts, old or brand new models and gives you pointers to 
the different distributions for code and installation instructions, 
For a User's Guide and other useful docs just select the link to 
the Linux Documentation Project, Then remember to install and 
configure the network stuff, the system manual pages, the 
compiler and debugger, and a friendly GUI (all freely included 
in nearly all distributions). Manual pages are very important 
because you can use them to know more about a command or 
a system call. If you want to know what is and how it works the 
socket() call, for example, just type man socket at the prompt; man 
man gives you details on how to use die man facility. At last, for 
troubles, doubts or questions not answered by the site or manual 
pages, there arc very helpful and polite dedicated mailing lists. 

On my Mac, I've installed a MkLinux DR3 distribution 
complete with manual pages, development libraries and the 
GNU C Compiler and debugger. Al! the article’s examples 
have been tested on ilus system and on a RedHaL 6.0 Intel 
box, but the concepts and the code are so general that ids 
quite easy to use them in another UNIX-like operating 
system, even not Mac specific. You don't need a real network 
to lest the examples, you can launch the programs on the 
same machine t provided that you have installed the network 
protocol stack and configured your computer 

Socket Basics 

In a L ] nbi like system, communications take place between 
endpoints called sockets within a communication domain , 
Domains are abstractions which imply both an addressing 
structure (address family) and a set of protocols implementing 
the various socket types within the domain (protocol family). The 
two most important domains are the UNIX domain and the 
INTERNET domain. They both allow processes to communicate 
but only the INTERNET domain allows communications between 
two machines. In the UNIX domain the socket is identified by a 
path name within the file system name space and communication 
is permitted between any two processes that reside on the same 
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machine and are able to access the socket pathname. The 
INTERNET domain allows communication between processes on 
separate machines with the Internet protocol family; the 
addresses consist of a machine network address and an 
identifying number called port. The type of the socket describes 
the semantics of the communication and its properties: 
reliability, ordering and prevention of messages duplication. The 
most known socket types are: 

* Stream socket This type of socket provides a bi¬ 
directional, reliable, error-free, sequenced and non 
duplicated flow of data without record boundaries. Stream 
communication implies a connection. 

* Datagram socket. Datagram sockets provide a bi¬ 
directional flow of data but don't guarantee that the 
datagrams will he received in the same order they were 
transmitted, or that they won't be duplicated. Record 
boundaries in data are preserved and a datagram 
communication doesn't imply a connection, 

* Raw socket. Raw sockets allow users direct access to a 
lower-level protocol: they aren't for the general user but 
for those that intend to develop new communication 
protocols or use some of the more particular aspects of an 
existing protocol. 

Ilie most common use of sockets is in a client-server 
architecture. In this model, client applications request services from 
a server process, The protocol implemented at both ends of the 
connection can be symmetric or asymmetric. In a symmetric 
protocol, both ends may play the server or client roles (eg. the 
TELNET protocol); in an asymmetric protocol one end is always 
the server and the other is always the client (e.g, the FTP protocol). 

In this article 111 give you complete examples of client and 
server processes using stream and datagram sockets in the 
INTERNET domain. 

Opening a socket is quite easy: 

int s = socket(int domain, int type, int protocol); 

'fhis system call creates a socket in the specified domain 
(AFJJNIX, Address Format UNIX, or AF_JNET r Address Format 
INTERNET), of the specified type ($OCK_DGRAM, for datagram 
socket, or SGCK_STREAM r for stream socket). We can specify a 
protocol too, but leaving it to 0 is usually the best choice: the 
system will choose the appropriate protocol in the domain that 
can support the requested type, usually UDP for datagrams and 
TCP for streams. 

Before accepting a connection or receiving a datagram, a 
socket must first bind to a name or address within the 
communication domain: 

bind(int s. struct sockaddr 'name. int namelen]: 

This call binds to a previously created socket s a name: an 
Internet address and port number in the INTERNET domain or a 
path name and a family in the UNIX domain. 


To send datagrams a client uses; 

sendtoCint s. void ’msg.int len, unsigned int flags, struct \ 
sockaddr 'to, int tolen); 

where to is the destination address. 

To receive datagrams a server uses: 

read(int s, void *buf. size_t count): 

or, when it needs to know the sender address: 

recvfrom(int s,void 'msg, int len,int flags.struct sockaddr V 
'from, int 'fromlen); 

To establish a connection versus a server, a client performs a: 

connect(int s, struct sockaddr 'server, int serverlen); 

The server parameter contains the UNIX pathname or the 
Internet address and port number of the server Lo which the 
client wishes to talk. 

To accept a connection from a client, a server must perform 
two more steps after the bindQ call: 

listen(int s, int pending); 

int newsock = accept (int s, struct sockaddr 'from, int \ 
'fromlen]; 

With the first call, a server indicates that it's ready to listen 
for incoming connection requests on the socket s; pending is 
the maximum number of connections that may be queued. 
The second call creates a new socket for die accepted 
connection; this is a blocking call, it will not return until a 
connection is available or is interrupted by a signal to the 
process. It is up to the process to cheek who the connection 
is from and close it if not welcome. 

When a connection is established, data may flow: 

write(int s, void *buf, size_t count): 
read(int s 4 void *buf* size_t count): 

are used to readAvrire up to count bytes from/into s into/from 
the buffer bub 

sendtint s, char 'msg, int len* int flags): 
recv{int s, char 'rosg, int len, int flags); 

allow options to be set by flags: these flags may be: 

* MSG_OOB, for out of bund data delivered to the user 
independently of normal data 

* MSG_PEEK, for reading data and leaving it as still unread 

* MSG_DONTROUTE f for sending data without routing packets 

Once a socket is no more needed it may be discarded: 
close(a); 

Client—Server Examples 

Now that we know the basic calls to work with sockets, let's 
get practical with a few complete examples. The first two listings 
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are a simple datagram server and client. You may compile them 
with these two commands irabbit> is my command prompt, gcc 
is the GNIJ C Compiler): 

rabbit) gcc -a dataserver dataserver.c 
rabbit) gcc o dataclient dataclient.c 
rabbit) 



The compiler will create two programs named dataserver and 
dataclient. When you launch dataserver, it prints out the port 
number on which it’s listening to and waits quietly for a 
message: 

rabbit) dataEerver 
Socket port #1039 


When you launch dataclient you have to specify in the command 
line the server name and the port number: 

rabbit) dataclient rabbit 1039 
rabbit) 

The client sends the message to the server rabbit on the port 
1089 and exits; the server receives the message, prints it to the 
standard output and exits: 

rabbit) dataserver 
Socket port #1089 
—) There was a time... 
rabbit) 


Listing 1: A Simple Datagram Server 


datascrvcix 

finclude Csys/typcs.h) 

{include Cays/socket.h> 

#include <rietinet/in.h> 

^include <gtdio.h) 

main {1 

I 

int sock, length: 
struct sockaddr_in server: 

charmsg[lQ24); // buffer lo store the message 

Wc create a socket in the INTERNET domain (AF lNET), of type datagram 
(SOCK. IXxRAM) and we choose the default protocot (0), in this ease UDP If the call 
fails, it returns a negative value and the program prints out an error message and exits. 

if ((sock - socket (AF.INET. SOCILJDGHAH. 0)j < OH 
perror("socket() call"): 
exit 11); 


Thai we set ail the values necessary to bind a name to the socket Wt specify again 
that we are in the INTERNET domain; we use the predefined value 1NADDR_ANY to 
specify that we want m receive messages from any network interface in die machine; 
we don’t set any particular port number from which to receive messages but we let 
the system to choose for us, Wc could explicitly set the port number (we ll do it in 
Listing 3) paying attention lo the already allocated port numbers of the wdI-known 
services. Note that port numbers under 1024 on be used by the root user only 

server.sin_family = AF INET; 
server.sin„addr.s_addr ” !NAl)DR_ANY; 
server.situport * 0; 

Wc bind the address to the socket: 

if (bind(sock, (struct sockeddr Observer. sizoof server) \ 

<0 H 

perror("bindQ call"): 
exit(I): 

I 
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length * sizeof(server); 

Because the system choosed a port number for it*. we have to find it and print it: 

if (getsockname(sock* (struct sockaddr * 1 )Server, &length)\ 

< 0)1 

perror("getsocktiame() call**): 
exit(l): 

I 

Numbers in Internet are represented using the big-endian byte-order MOhsQ deals 
with tilt possible necessary conversion from the network representation to die host s 
internal representation. 

printf{"Socket port (jhtd\iT, ntohs(server,sin_port)); 

Now we read the message from the socket, prim it to the standard output, dose the 
socket and exit the program: 

if (read(sock, msg* 1024) < 0) 
perror(“read() call u ); 
ptintf (**--) msg): 

close[sock): 
exit(0): 


Listing 2: A Simple Datagram Client 


daradicm.e 

//include <$ys/types.h> 

//include <sys/socket.h) 
if include <netinfct/in,h> 

//include <netdb.h) 

//include <sidlo.h> 

This is the message we'll said in the datagram: 

//define MSG "There was a time..." 


main(iat argc.char *argvf]) 

t 

Int sock: 

struct sockaddr_in server: 
struct hostent p server_data: 

Wc create a socket as before: a datagram socket in the INTERNET domain with die 
default protocol: 

if {(sock - socket(AJL1NET, 50CKJ1GRAM. fl>) < 0)1 
perror{"socket() call”); 
exit (1): 

1 

In the command line we specify the server name, not its address gcthostbynameO 
returns a structure containing the address of the server. 

if {£server_data *= getbostbytiame Urgv (l j)) ^ 0) t 
fprintf[stderr, u \s: unknown host",argv[ij); 
exit(2): 

I 

We «et the data necessary to send the message to the server the server address, port 
and protocol family Note the conversion from the host s number representation to the 
network representation, hiousQ. 

memepy(^server,sin_addr.server_data■>h„addr, \ 
server data->h_length}; 
server.sin family = AF INET; 
server,sin_port ” htons(atni(argv[2 ])}; 

At Iasi wc send the message, dose the socket and exit the program: 

if (aendto{sock,MSG,sizeof MSG, 0. (struct sockaddr *) \ 
^server, sizeof server)< 0) 
pnrror(**sendto() call **): 
close(sock); 
exit(0); 


Next two examples show a stream server and a stream 
diem. They are a little bit different from the previous ones. The 
server program waits for connections on a specific port number 
(2907) and doesn’t terminate after receiving the first message but 
waits for the next connection. You may compile them with these 
two commands: 

rabbit) gcc -o streamserver streamserver,c 
rabbit) gcc n stteamclient streamclient ,C 
rabbit) 


The compiler will create Lwo programs: streamserver and 
streamclient, When you launch streamserver, it waits quietly for a 
connection on port 2907: 

rabbit) streamserver 

When you launch dataclient you have to specify only the server 
name in the command line: 

rabbit) streamclient rabbit 
rabhit) 


Tile client makes a connection to the server rahhU on port 2907, 
sends the message, closes the connection and exits; the server 
accepts the connection, reads the message, prints it to Lhe 
standard output and waits for another connection: 

rabbit) streamserver 
—) There was a STREAMING time .,. 

Ending connection 


Listing 3: A Simple Stream Server 


streamserver c 

//include <sys/types,h> 

//include <sys/socket * h) 

//include <netinet/in,h> 

^include <netdb.h> 

//include <stdio.h) 

main/} 

I 

int sack* length* readn: 
struct sockaddr_1n server: 
iut msgsock; 

char msg, [1024]: 

Wc create a socket in die INTERNET domain, of type stream (SOCKJTTREAM) with 
the default protocol, in this case TCP: 

if((sock = socket(AF_INET. S0CK„STREAM, 0)) < 0)1 
perrqr("socket() call**): 
exit(1); 

I 

This time we choose a specific port fur uur servo - to listen to: 2907 is a number 
greater than 1024, so that wc don't have to be root to execute the program, and it’s 
not bound to a well-known service. Of course you can do as in the Listing 1 example, 
this is just to present you with an alternative 

server. sin_f ami ly = Alr_lNET: 
server.sin_addr.s_addr = 1NADBR_ANY: 
server .sin., port 3 2907: 

if (hind(sock, (struct sockaddr ‘J&server. sizeof server) \ 

< 0 )l 

perror("bind () call **): 
exit U); 

I 

W r c mark the socket as ready to receive connections. Since seven! clients may attempt 
to connect, the system maintains a queue of pending connections; Lite listcuO call 
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initializes tills queue and set the maximum number of pending connections. 

listen{sock,5); 

We enter an infinite loop.the acccpt() call will take a pending connection request 
from the queue if one b available or block waiting for a request When a request b 
accepted, a new socket b created.When the connection b dosed by the diem, the 
rcadO call reiums zero and the socket b closed. 

for <;;) I 

if Citnsgsoek “ accept (sock, NULL, NULL)) = -l) 
po r ror£"aecept£5 call"); 
else do I 

memset(msg, 0, 1024): 

it' (Creadn - read (msgsock* msg. 1024)) < 0) 
perror("read(} call”); 
if {readn »» 0) 

print!("Ending connection^"): 
else 

printfU—> Xs\n'\ mr.g ): 

1 while (readn l & 0); 
close (msgsnek); 


Since we entered an infinite hxip. Ihc socket sock is never explicitly dosed. All sockets 
ane automatically dosed when a process b killed or terminates normally. 

exit {0): 

I 


l uting 4: A Simple Stream Client 


strcamdtent.e 

ffinc lud e <sy k/ types, h) 

//include <eys/socket,h> 

//include <nctinet/in.h> 

//include <netdb.h> 

//include <stdiD.h> 

This is live message we ll send over the connections 

#define M$C "There was a STREAMING time 

mainCinL urge,char *argv[]) 

I 

int sock: 

struct eockaddr_in server: 
struct hostent *scrver_data; 

We create a socket in the INTERNET domain, of type stream (NOCK_5TRbAM) with 
the default protocol: 

if{{cock - socket(AF DIET, SOGICSTREAM, 0)) < 0)1 
perror(“socket() call"); 
exit U); 

1 

server h sin_family = AF_1NET; 

We retrieve ihc IP address of Ihe server from its name: 

if((server data ” gel hosLbyname(argvLlJ))==0)1 
t'printf (stder r, *%s: unknown host",argv[l]h 
exit (1); 

I 

memepy£Aserver.sin_addr. server_data->h_addr, \ 

server_data->h_Ungth); 
server. $in_pOrt “ htons £ 2907 } : 

Wc initiate the connection and, after it has been established, we send the message: 

if (connect £ nock, (struct sockaddr *)&server,'nzeof server) \ 

< 0)1 

perror{"connectO call"); 
exit U); 

I 

if(write(sock. MSG, sizeof MSG) < 0) 
perror£"vrite£) caII“): 


Hie connection b closed clewing the socket If a process persists in sending messages 
after the connection is dosed, a SIGPIPli signal b sent to the process by the operating 
system.The process will then terminate unless die signal Is handled, for example, with 
the signalO call. 

close(sock)■ 

exit(0); 

I 

Good. Now we know how to write simple programs to 
deal with datagrams or streams. Let’s complicate things a 
little. What if we need Lo process data while we are waiting 
for a datagram or a connection? Or what if we need to open 
more than one socket? The read() and accept) calls are 
blocking calls + , + There are two solutions: a synchronous 
solution and an asynchronous one. 

The synchronous solution is so called because we control 
how to multiplex input/output requests among multiple 
sockets, in a sort of polling policy. Listing 5 shows such a 
solution. A socket identifier can l>c treated as a file descriptor 
so we can use the setectQ call. The selectQ call takes among its 
arguments pointers to ihree sets of file descriptors: one for the 
set of file descriptors on which we wish to read data, one for 
those on which we wish to write and one for exceptional 
conditions (e.g. out of band data). When we are not interested 
in a particular set we have to set the pointer ro NULL. Each seL 
is implemented as a structure fd set containing an array (of size 
FD_SETSJZE) of long integer bit masks. Two macros, 
FD_SET(fd,&mask) and FDJXRdd&mask) are provided for 
adding and removing file descriptor fd in the set mask. Before 
using iL f each set must he zeroed with the FD_ZERO(&mask) 
macro. The last argument of selectQ sets a timeout value, in 
seconds, that specifies how long at max the select() call must 
last. If the timeout value is set to zero, the selection is like a 
poll, returning immediately. Assuming a successful return of 
select() call, the tiiree sets will indicate which file descriptors 
are ready to be read from, written to or have exceptional 
condition pending. The macro FD_ISSET(fd,&mask) tests the 
status of a file descriptor in a set; it returns a non-zero value if 
fd is a member of mask, 0 otherwise. 

You may compile the code wath this command: 

rabbit) gcc -o selectserver selectserver.c 
rabbit> 

The compiler will create the program selectserver. When you 
launch selectserver, it waits quietly for a connection on port 2907 
or on port 2908: 

rabbit) selectserver 

As clients, you can use the code in listing 4, modified to use 
port 2907 (datadientl) or 2908 (datadtent2): 

rabbit) dataclientl rabbit 
rabbit) dataclientZ rabbit 
rabbit) 

The server accepts connections on Lhe two ports and when is 
not serving a client prints the message “Do something eise". 
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Listing 5: A Synduronotis Stream Server 


sekctscnrr.c 

#include <sys/types.h> 

//include <sys/socket.h) 

//include <sys/tiMe.h> 

//include <netinet/in,h> 

//include <netdb,h> 

^include <stdio,h> 

nflin() 

l 

itit sockL sockz. length, readn; 

struct sockaddr.ln server; 

tnt migsock; 

ebar msg[ 1024 ]: 

fd_set readmesk; 

struct timeval timeout: 


if((aockl * socket(AF_TNET f SOCK_STREAM* 0)) < 0)1 
peircurC “socket () call 1"); 
exit(l); 

J 

server,siruJamily * AF_INET: 
server.sin_addr♦s_addr ■ TNADDR .ANY: 
server,sin_port = 2907: 

if (bind(sock!, (struct sockaddr *)kserver, \ 
sizeof server) ^0 )\ 
perrorf"bind£) call I*): 
exit(1); 

1 

ifC(sock2 “ socket(AF_TNET t SOCKSTREAM. 0)) < 0)1 
perror(“socket() call 2 W ): 
exitU): 

1 

server f sin_family ” AF_TN£T; 
server. sin_addr. s_add r ” TNADDR. .ANY: 
server.sin_port = 2908: 

if £bind(sock2, {struct sockaddr *)&server, \ 
sizeof server) <0 )| 
perror(*bind() call 2“); 
exit (U: 

1 

listen(aockl,5); 
lisfen(sock2,5): 

for (;:) I 

FILZSR0 £ Ar eadmask); 

FI3_SET£sockL ireadmask); 

FD_SET(sock2, frreadmask); 
timeout »t.v_8ec w 2 ; 

if(select(FD_SET5IZE, fcreadraask. NULL. NOLL. \ 

StUKOUt) < 0) ( 

perror(“selectt) call"); 

continue: 

I 

if(IDJTSSBT(uoekl* &readmask))[ 
msgsock " accept(sock1. NULL, NULL): 
ifTmsgsock * 1) 

perrort“accept£) call 1"); 
else do I 

tnemset (msg, 0, 1024); 

If £(readn - readfmsgsock, msg, 1024)) < 0) 
perror("read() call 1“); 
else if (readn 0) 

printf ("Ending, connection l\n"): 
else 

printf(“290? > %sW\ msg); 

) while (readn > 0); 
close Emsgs&ck); 

I 

if(FD„TS$RT(eock2 t &readmask)) I 

msgsock " accept(sock2, NULL, NULL); 
iflmsgsock = l) 

perror(“accept£) call 2“); 
else do ( 


metnset(msg, 0, 1024); 

if ((readn = readCmsgsoek* imsg. 1024)) < 0) 
perror(“readt) call 2"); 
else if (readn — 0) 

printft“Ending connection 2\n“]; 
else 

printf("2908 - > %$\n", msg): 

I while (readn >0): 
close (msgsock); 

I 

printf("Do something eiseVrT); 

\ 

exit (0): 


The code in Listing 6 is an example of an interrupt driven 
socket. This example isn't working under my Mk Linux box, but 
works perfectly under RcdHat Linux 6.0 on an Intel box; I’d like 
to know your results if you have occasion, to try it on a different 
system (linuxPPC, NetBSD..,) :) . The signal SIGIO notifies a 
process when a socket has data waiting to be read. There are 
three steps that must !>e completed: writing a signal handler for 
the SIGIO signal with the signaf{) call; setting which process id 
has to receive the SIGIO signal with the fcntl() call; enabling the 
asynchronous notification with another fcntl() call You may 
compile Lhe code with this command: 

rabbit) gcc o Interruptserver interruptsetver .c 
rabbit) 


The compiler will create the program interruptserver, When you 
launch interruptserver, it waits quicily for a datagram, prints it 
and then exits. You can use the code in Listing 2 as a client 
program. 


Listing 6: An Asynchronous Stream Server 


lmcrruptserverc 

//include <syE/types,h> 

//include <sys/aocket,h) 

//include (netinet/in.h> 

^include <netdb.h) 

//include <fcntl .h> 

//include <sxgnal.h> 

//include <stdio.h> 

tnt sock; 
char tnsg[10241: 

nminO 

I 

int length; 

struct sockaddr_in server: 
void in handler(); 

Wc declare: that after reception uf SIGIO signal the process must call the JuJiandloO 
function: 

signalCSIGIG* iojtandler); 

We open a datagram socket: 

sock - socket(AF.INET. SOCR_DGRAM* 0): 
if (sock < 0) I 

perror £"socket() call"): 
exit(1); 

1 

server,sin_famity = AF^INET; 
server.sin_addr,s_addr = 1NADUR_ANY; 
server.sin_port = 0; 

if (bind(sock, (struct aockaddr *)kserver ( \ 
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sizeof server) <0 )f 
pe r tor ('‘bind t) cal 1 - : 
enitCl); 

I 

length “ sizenf(server); 

if (getsor-knameCsock. (struct sockaddr *)&server, \ 
^length) < 0} ( 

perror("get. socket name 0 call 4 *); 
exit U); 

J 

print f(“Socket port mobs (server .sin^port)): 

Wc set the process receiving S1GIQ to us. Jliq getpidQ call returns this process pid 

if (fcntKsock* F_SETFL, getpidO) < 0) ( 
porror( 44 fcntlf} F_SETFL, getpidO 44 ): 
exit(1): 

I 

We allow the receipt of asynchronous signals: 

if (fcntl(sock„F_EETFL,FASYNC) < 0 )i 
perrort "fcntlO F_SETFL, FASYNCT); 
exit(1); 

J 

for{ i ;) 


This is the signal handler called after the reception of the SIGIO signal. It prints the 
message, doses the socket and terminates the program 

void io.handler{) 

printf(*T waz called!Yn H ): 

If (read(sock, msg, 1024) < 0} 
pe rro r(“read() call"); 
printf( 4, “"> %sVn'\ msg); 
close(sock); 
exit(0); 


Conclusions 

OK, that's all. I've tried La give you some basic and 
advanced notions about network programming with sockets, 
presenting you code examples of datagrams, stream 
communication, synchronous I/O multiplexing and interrupt 
driven sockets. The choice between datagrams and socket 
streams is done carefully considering the application 
requirements in terms of semantic and performance. Datagrams 
are faster because don't require a connection setup, but the 
complexity of the program can increase a lot if you don't want 
lost or out of order messages. Stream connection setup takes 
longer and is often unnecessary for small amount of data, but 
could lx: the winner solution for reliable delivery of large 
amount of data. Synchronous I/O multiplexing and interrupt 
driven sockets are used in programs that need more than one 
communication channel or have to fast react to asynchronous 
events like user’s commands. 

Now it's up to you, have fun! 
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Fitting the Desktop into a TCP/IP Environment 


Working with Mac OS 

ami Windows in a Unix environment 


Welcome 

This article is based on my 
experiences in the last year and a half in 
converting my non-Unix network from 
AppleTalk and NetBIOS to 99% pure 
TCP/IP, or as close as 1 could get. 
Although this article primarily focusses on 
Macs, 1 will also deal with the PC side, as 
they are both intertwined in this project. 

Background 

When l started in my current position, 
the original non-Unix network was, to put 
it mildly, a mess. This was not due lo 
incompelence, or a lack of desire to do 
things right, but to two elements: 

1. The Macs had been so easy to network, 

that there hadn't been a need to think 
about them, so they just 'grew in place.' 
This caused a lot of hidden problems, 
which 1 will go through in more detail 
The Macs were there, they mostly 
worked, and therefore were okay, as far 
as the net managers were concerned. 

2. Both of the current staff were ignorant 
of the ways that the WinTd 
architecture functioned, and had 
bought all the PCs pie-< on figured from 
a local vendor A nice idea, but as we 
will see, not a practical one. 

I was lucky in a way, since as there 
was no actual architecture tor the non 
Unix machines, I was free to create one. 


The downside of this, of course, is that 1 had to create one from 
scratch, and as any artist will tell you, creation can l>e painful. (I 
do consider myself an artist in that most of whai I do requires an 
eye for the creative, as any IS. pro will tell you). 

Problem Identification 

The Macintoshes at this site were running a mixture of Mac OS 
versions 7.0.1 to 7.55, with various forms of MacTCP and Open 
Transport (OT) TCP/IP stacks installed. Appletalk was intensively 
used lor all printing and file sharing duties. All Unix server access 
was performed via Syntax's Total Access Server (TAS), running on 
Solaris. All Windows network access used AppleTalk network stacks 
running on die PCX All printing was via various forms of Apple's 
biserWriLer driver over FiherTulk, 

The PCs were all WindowsDS, with various service packs, 
accessing the l nix file systems via TAS, and the Macs via AppleTalk 
stacks. All printing was done through either AppleTalk, or Hewlett 
Packard's (HP) JetAdmin software, and in some cases Ixxli. The 
printing was further complicated by the JetAdmin version's 
requirement for NetWare as die printing protocol. In effect, die PCs 
were using four protocols just to live on the network. 



John Welch <jwekh#aer.eom> is an l.S. Professional at a weather and aimaspheric science company in Cambridge, 
Mass, lie has over fifteen years of experience at "making computers work ’ He has worked t>n almost every platform, 
and is keeping his options open. 
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Backups were performed for these systems by a Mac running 
Dantz Development’s Retrospect 4,(X Although an excellent and 
reliable product, the backups were mnning across a mixture of 
AppleTalk and TCP/IP, slowing overall performance. 

The problems with this system, or lack thereof, were many; 

1. Due to all the different MacOS versions, troubles hooting a 
problem required sitting at dial user's Mac, and testing, 
because trying to reproduce the problem elsewhere 
introduced too many variables into the test. 

2. Tiic multiple versions of the Mac networking slacks made 
troubleshooting network-related problems difficult and 
tedious. Even relatively simple problems required weeding 
out known issues with versions of OT and MacTCP. 

3. The PCs using AppleTalk and NetWare were causing more 
than a few problems for those systems. 

4. The use of AppleTalk and NetBIOS on a TCP/IP network 
caused performance and reliability issues for the Unix users 
as well as other platforms. 

5. There was no central way to monitor the printer queues to 
see when a job was blowing up or stalling the printers, 
because the Macs and PCs printed directly to the printers. In 
addition, the PCs were using vendor-specific drivers for 
printing, again making maintenance difficult. 

6. Although TAS is a gtxxl server product, using AppleTalk and 
NetBIOS as an interface for Network File System (NFS) shared 
file systems was adding a layer of complexity to tin* network. 

7. The PCs had various types of 'combo* cards installed, 
attempting, to combine networking, video, and sound onto 
the same card, Tn each case, only the video worked, so 
additional sound and networking cards had to be installed, 
resulting in duplicate cards for these functions. This made the 
hardware reliability of the PCs sketchy at best* 

8. Finally, the backups needed to \w reduced to a single 
protocol where passible. 

Tuii Fixes 

Get everyone on the same OS page 

The first order of business w-as to move each platform 
onto a current and consistent OS version. By this time, Mac 
OS 8,0 had been released, so all capable Macs were 
upgraded to this version. This left about five Mac list’s out in 
the cold, because OS 8 would not run on Macs with that 
processor, (68030). Rather than upgrading them to version 
7.6.1, we decided to purchase new machines for these users, 
and for other users whose needs outstripped their hardware. 
Since the G3 was not available to us, the machine settled on 


for desktop Macs was the 8600/300, with the Mach 3 604e 
processor. The 8600s were equipped with 12H MB of RAM, so 
that Conned tx Corp’s Virtual PC (VPC), also purchased wilh 
each Mac, would be available (see sidebar), 

Emulation issues 

Although I have seen many people dismiss MX] and oilier 
emulators out of hand, by making sure that each Mac was able to 
devote 100 MB of RAM to VPC T we have gotten consistently gotxl 
performance our of the product, I have seen performance equivalent 
to that of Citrix’s MctaFrame product at least in almost every case. 

For laptop users, we purchased either PowefBook 
34G0/240s or 2400/180s, along with one first generation 
PowerBook G3. This phase took approximately five months to 
complete. When we finished, only one 68K Mac was left in 
use, and it was targeted for replacement within the next month. 

The result of moving everyone to the same OS level is 
that the Mac users realized immediate gains in reliability and 
performance. One of the side benefits was ihar a growing 
desire lo replace all the Macs with PC’s was now seen as 
unnecessary. The same benefits occurred with networking, 
since everyone was now using the same version of OT (L2), 
this gave them gains in performance and reliability. From an 
IS perspective, [TK tilt in missing sentence fragment or 
removelthe consistency between the platforms immediately 
slashed maintenance and troubleshooting time as problems 
could be duplicated or verified at more than one workstation. 

On the PC side, all the machines running Windows*)5 
were upgraded to the most current Operating System Release 
(OHIO version. This allowed the use of PowerQuesCs 
PartitiunMagic lo convert the Windows machines’ hard disks 
to FAT32, Use of FAT32 resulted in a more stable file system, 
and some fairly impressive (300MB Lo 700MB), space 
recovery on those drives, along rhe same lines as the gains 
Mac users experience when moving to I IPS Plus with Mac OS 
8.1. In addition, the troublesome combination 
vidco/sound/network cards [TK were these mentioned earlier 
in the list of problems? If not, identify ’em more thoroughly 
here} , which had only worked as video cards, were replaced 
by reputable models. We used ATI or Matrox (video), 
SoundBlaster (sound) and 3Com, (network) cards. The new 
cards resulted in each of these features now being usable, 
and eliminated a lot of squirrelly drivers from the mix. 
Finally, the HP JcLAdmin software in the PCs was updated to 
allow the use of TCP/IP instead of NetWare a nd AppleTalk to 
prim, again, eliminating errors and problems by simplifying 
the configuration. 

We started in August *97, and by January ‘99, we had 
finished one part of the conversion to TCP/IP. We also joined 
the Apple Developer Program, installed two new' web 
servers, including a Power Macintosh 8600/300 running 
Webstar 2,x and Rumpus, Lx. (For FTP services). [TK 
mention the platform?), converted from 2 Mb Ethernet with a 
10Mb backbone, to 10Mb Ethernet with a 100Mb backbone. 
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upgraded all the Sun machines to Solaris 2.6, and installed a 
new email system. The next step was to deal with the 
printing issue, 

Printing the Unix way for fun and profit. 

The printing differences between Unix and the other 
machines had been the cause of a few arguments in the 
company. The Unix users could easily check on each other's 
print jobs, and primer status, buL could not tell when the 
delay was caused by a Mac or PC print job, Since in the 
science world, a PostScript file of a color plot sent to our 
color printer (a Tektronix Phaser 550 with the 1200dpi 
option, if you're curious) could easily exceed 2QMB t making 
the wail for an unknown job to finish mildly frustrating, 
especially if you had one of your own to process. 

'ITie most logical solution was to get the Macs and PCs to 
use the existing Line Printer (LPR) server, and print over 
TCP/IP, which increased the efficiency of printer usage, and 
allowed for more accurate print job monitoring, plus 
eliminated a lot of AppleTalk and NetBIOS usage. The Macs 
were helped by the fortuitous release of Mac OS 8.1, which 
included the LaserWriter 8.5.1 drivers and LPR printing support. 
The upgrade was quickly implemented and by mid-February to 
early March, all our Macs were printing solely via TCP/IP to our 
main Unix print server. The Mac users were happy that their 
print speed was much faster (spooling to a server is faster than 
spooling to a printer), the Unix people were happy that the 
number of unknown print jobs had dropped by over half, and 
the IS staff, were happy because we now had better control 
over how- the printers were being used. 

On the PC side, our TCP/IP printing architecture was 
implemented in two phases. The first was the purc hase of a 
site license for the Exceed X-Windows package, from 
Hummingbird. Primarily intended as a way For Windows 
users to access Unix programs instead of using telnet, the 
Exceed software included an LPR prim server, which allowed 
us to create new pons for the existing IIP and Tektronix 
printers. These new ports rerouted the prim jobs to our main 
Unix print server. All users were now placed in the same 
printing queue(s), which provided better monitoring and 
control over print jobs and problems. In addition the PC 
users received faster printing times, and fewer system errors 
from the IIP drivers, which were turned off at this point. For 
our, Windows NT users, that 05 has built - in LPR 
capabilities, so it was a matter of installing the correct printer 
drivers, and connecting them to the appropriate ports. 

The next step for the PC users was to replace the 
multiple vendors" printer drivers with one better suited to the 
printers we own and the way we print. Since all of our 
printers are PostScript, the only logical choice was Adobe's, 
The Adobe drivers were installed, and again, printing 
became a much more reliable and forgettable process. (It is 
my firm belief that in the IS business, the best programs are 
the ones that do their job so well, you forget they are 


running. Obviously this list is too short.) A side benefit was 
that we are now able to use one PostScript Printer 
Description (PPD) file for all of our platforms, so LhaL all of 
our users can print with consistent capabilities and quality, 
regardless of platform. This final phase was only completed 
within the last few months. 

Connecting the whole world in a consistent way 

The final and most complex step to our total solution 
was the file connections. There had been no standard way 
for all the computers on our network to connect to each 
other, so as a result, we had a chaotic conglomeration of 
confusing configurations and protocols, from TCP/IP (Unix), 
to NetBIOS (PC), to AppleTalk (Mac), 

Although w r e were using the TAS product, it had several 
disadvantages, among them, speed, (it was agonizingly slow 
on the AppleTalk side, to the point of causing even our G3 
systems to grind to a halt to even mount a drive), TAS was 
also a very complicated product to deal with, the worst 
example being the way it dealt with the Mac OS's dual file 
fork system. TAS would keep ihc resource forks in a separate 
directory, and use index files to match them when a Mac 
would attempL to access them. Unfortunately, this was 
unreliable, as about 20% to 30% of application files would 
become corrupt under this system. In addition, if a file was 
moved or added using the standard Unix commands, and it 
was a Mac file, it lost the resource fork, and become corrupt 
and crashed machines when accessed via AppleShare (we 
determined TAS was responsible for this by LTPTng ihe same 
file to a Mac, which allowed it to be used without error.) 

On the PC side, the password setup was unreliable for 
Windows 95/98, and for Windows NT because it required a 
registry edit to enable plain text passwords. Since well over 
50% of our systems and 95% of main servers are Unix 
machines, the obvious solution was to install an NFS client 
on the Macs and PCs. After some diligent and obscure 
searching, I found a solution for both platforms, 
lniragyAccess, from Ascend Communications. IntragyAccess 
is a suite of TCP/IP applications, including an LPR client and 
Server, an FTP server, and, most importantly, an NFS client. 
By installing the NFS client on both the PCs and the Macs, 
we were able to complete most important part of the puzzle: 
Unix fileserver access. To handle the issue of non Unix file 
access, for tilings like PC to Mac filesharing.wc implemented 
two solutions . 

First, we purchased a G3/300 AppleShare IP (ASIP) 
server Version 6,0 of ASIP supported Windows access via 
Server Message Block (SMB) protocols, so litis Mac is able to 
function as a network install point for both the PC and 
Macintosh machines. Due to the implementation of a LPR 
server in ASIP 6.X, it has also, on occasion, functioned as our 
backup printer server. The server is also our Retrospect 
server, and has 3 sets of mirrored hard drives, and backs up 
to a seven - tape Digital Linear Tape, (DLT) changer, and 
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also holds a Zip, and a 2GB Jaz drive. (The floppy was pulled 
Lo make room for I he Jaz.) The G3 server is also running 
Pi I maker Pro as one of the main applications on the corporate 
intranet. To allow the PCs and Macs to share files easier, we 
have begun to install DAVE, from Thursby Systems. This 
allows the Macs to use SMB as a filesharing protocol for two 
- way file access between Mac and PC systems. DAVE is 
essentially an IP-based NetBIOS stack for the MacOS, so it 
fits in nicely with our network strategy. 



Conclusions 

Although the complete changeover described took a 
year, and went on simultaneously with a lot of other projects, 
it has been worth it so far. Cross-platform file access 


(considering we have more than 3 versions of Unix, that is a 
bit more than the usual meaning of crass-platform) has 
improved in both speed and reliability. With all our priming 
routed through the same server queues, monitoring and 
handling print jobs has become much easier Although the 
printer hardware is no faster, the spooling process is faster 
and the users are quite pleased. Currently, unless a Mac to 
Mac file transfer is taking place, almost 100% of all traffic on 
our network is TCP/IP, and we are able to maintain an 
average speed of 6+Mb/sec on our lOBaseT Ethernet lines. 
In short, it has been a rousing success. 

That is not to dismiss the effort behind the upgrade. This 
was a year of hard, and often frustrating work. Neither PCs or 
Macs really are yet designed for 100% TCP/IP utilization, but it 
is getting much easier. It takes a lor of planning, diligence, and 
discipline to stay focused on what can lx: an ephemeral goal, 
bill the end result is a better used and maintained network, dial 
can easily handle almost any client. 

Resources 

* Adobe - http://www.adobe.com 

* Apple Computer, Inc. - h Up://www.apple.com 

* Citrix - http://www.citrix.com 

* Connectix - http://www,connectix.com 

* Danlz Development - http://wwwulantz.com 

* Hew lett Packard - http://wwwJip.com 

* Hummingbird - http://www.hummingliird.com 

* Novell http://www.nnvell.com 

* Solaris - http://www.sun.com 

■ Syntax's Total Access Server (TAS) - http://w w w.symax.com 

* Thursby Systems - http://www.thursby.com 
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FROM THE 
FACTORY FLOOR 


by Ron Liecbty, ©2(XXJ by Melrowerks, Inc., all tights reserved. 


Ron Liechty on the Spirit of 
Macintosh Developers 


This month's interview is with Ron Uechty, who gives us 
his insights on Lhe past, present and future 1 of Macintosh 
development 

Ron liecbty is the ombudsman and a ward- 
ummlng online represen fit tire for Metrowerks. Ills e-mail 
box is always open at M WRowetrowerks,com A 
grandfather with two grandsons Jaymz and Jaysn and a 
granddaughter Odessa, lion tvorks from his home Ik 
Michigan tenting technical documentation and 
providing online support for Metrowerks' customers. 

As someone who's been involved with Ccxlc Warrior 
development from its earliest days, you've had a 
ringside seat as the Macintosh community has 
matured. How do you think the Mac development 
community has ciianged over the years? 

Ron: There is a new sense of competitiveness among 

Mae programmers today that didn't exist years ago. 
Not competitiveness between each other, but with 
programmers developing for other operating 
systems. There is a realization that Macintosh 
programs have to be better than the other operating 
system, in the early 1990s programmers relied on the 
interface to be superior and to sell their products for 
them. Now Macintosh developers have realized that 
no matter how superior the Macintosh operating 
system is, their products itili si also be better than 
their counterparts’ on other operating systems. 

What hasn't changed is the helpfulness of the Macintosh 
community online, I see Java programmers and catch a 
glimpse of the camaraderie that is evident in the Macintosh 
developer community. However, it never matches the 
amount and quality of help that Macintosh programmers 
give each other. 

Where are some of the best places you've seen w here 
Mac developers can go for help? 


Ron: There are many avenues for help to lx>th new 

programmers and seasoned veteran programmers, 1 wish 
I could mention all of the folks that are out there 
providing help internationally, li is amazing, the speed 
and depth of help you can get on the newsgroups and 
other Internet sources. 

Of course, there are the institutional resources, like those 
provided by MacTech: 

Macintosh C by K. J. bricknell and Macintosh Pascal by Koryn 
Grant and K. J. Bridcnell. 

These online resources consist of a Ixiok and a package of 
demonstration program files easily downloadable from: 
<http://www.maaech.com/macintosh-c> 

Apple has an excellent online source for developers at the 
Apple Developer Connection web site: 
<http://www.applacom/developer/> 

My jDersonal favorite Apple link is the page tor Mac OS 8 and 
9 Developer Documentation: 

<http://developerapple.com/techpybs/Functionlndex/Functionlnctex.htmt> 

This index provides links to function descriptions from 
Inside Macintosh arid from new and revised Mac OS 8 
documents. From there you can find sample code and 
white pages in regards to the various functions as well 
as a description of their use. 

Individuals and groups also work together to provide help 
with programming. An example is the group of Mae 
programmers Lliat help with online self-study groups known 
as MOST. You can access the MOST web site at: 
<http://www.themo5t.org> 

The MOST web site and services are the gifts of altruistic 
Mac OS professionals and amateurs to anyone — high 
school/college students, developers for other platforms, or 
current Mac OS dcve!o|>er — who wants access to net- 
based resources which will help them produce high 
quality Mac OS applications. 
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Another independent list server is AIMED-TALK, which is 
a discussion list for AIMED (the Association of 
Independent Macintosh Engineers and Deveiojxrrs.) 

The purpose of AIMED-J ALK is to discuss information that 
AIMED members are concerned with, new memlx!rs want 
to know about, and interested (potential future members) 
want to find out about. 

Send E-mail with a blank subject line and the command 
SUBSCRIBE as the first (and only) line of the message 
body to: <afmed-talk-requesT@aimed.org> 

For Macintosh Pascal Programmers, Bill Catambay hosts 
Pascal Central, which can be found at: 
<http://pascal<entraLcom/> 

The intent of Pascal Central is to provide the Pascal 
community one place to obtain Pascal technical 
information, Pascal source code, and Pascal-related 
Internet links. 

Speaking of Pascal, there is the Mac:Pascal list server, 
which is always eager to help others at any time; 
<li stserv@l ist. sta i rway s, com > 

Metrowerks is planning on having an online support 
FAQ and already has several white papers regarding 
our technology online. 

It seems like some individuals are online helping others 
24 hours a day, .seven days a week. One of those is Miro 
Jurisic, who hosts a Code Warrior FAQ at the following 
address: <htLp://cw-faq.miLedu/cw-faq/faq> 

Ikii Miro is noi alone. There are literally thousands of 
individuals that are online offering tech support and 
advice to each other on the newsgroups* 

There arc so many helpful people online that it would 
be impossible to name them all. They span the globe 
from Australia to the Austria, from South Africa to 
Sweden. WhaL always amazes me is how contagious it 
can be. I see a person sign on as a newbie asking for 
help and within a few days that person is helping 
otliers with their problems. 

I browse scores of newsgroups every day, and there are 
none with the camaraderie and bmtherhcxxl exhibited on 
die comp.sy*mac.programmer newsgroups: 

comp.sys.mac. program mer.codewarr tor 
tomp.sys.mac.Gop. power plant 
comp.iang.pascaLmac 
com p.sys. mac. program merToots 


com p.sys,macprogrammer. help 
com p.sys.mac, program men misc 
com p.sys.mac, programmer, info 
com p.sys.macprogrammer, games 
comp.sys.maeoop,macapp3 ( 
com p.sys.macoop. misc 

When it comes to helping others, Mac Developers have 
an open heart and give sage advice. When I see this 
spirit and openness I know lliat the Mac will always be 
the premier operating system. 

Looking back, whai do you think were some of 
the most important developments surrounding 
the Mac over the years? 

Ron: Clearly the PowerPC chip was the most significant 

change in the Macintosh over the past 10 years. When 
Apple introduced ins PowerPC computers, the Macintosh 
was on a slow decline, losing market share every year. The 
PowerPC revitalized the entire Macintosh community. No 
longer did the Mac just have a letter operating system, 
now it wits faster. Many people have given Metro werks a 
lot of credit for helping Apple's recovery with Code Wamot 
and the early investment Merrowerks made in the 
PowerPC chip. Mctrowcrks ! xTicved in PowerPC, and 
Code Warrior gave programmer a way to easily transition 
their 68k applications to PowerPC, to make them HAT so 
they would run on both operating systems. 

The second most important development was the 
emergence of the Internet. Macintosh is the premier 
operating system for the Internet* Nothing 
interoperates with the Internet as fast as smooth or as 
seamlessly as a Macintosh. 1 have one of those other 
operating systems and trying to use ii for mail or web 
surfing is painful compared to using my Macintosh* 
The Internet has helped level the playing field among 
operating systems and forced a commonality in file 
types. Five years ago 1 would estimate that 80 percent 
of the computers sold for the home market were sold 
for gaming. Now I would estimate that 80 pereenl are 
sold for Internet access. Apple lias reinvented itself 
with the I-Mac and has created another resurgence in 
Macintosh development. 

What lies ahead for Mac developers as we begin die new 
millennium? 

Ron: Every five years the home computer reinvents 
itself. In the early 80s it was a toy — a gadget for 
gadget freaks. Then in the mid-80s it became a tool for 
students, necessary for word processing and small 
databases* In the early 90s it became the game players' 
machine, as faster graphics, cheaper RAM and 
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processor speeds made dramatic improvements. In the 
laic 90s and now at the Lurn of the millennium, we’ve 
seen the Internet become probably the most important 
factor in the use of home computers. 

If I knew what the next reinvention would be, I’d 
certainly be a billionaire. One can, however, speculate 
on what will he happening in ihe years to come. 
Certainly a blending of television with computers is 
inevitable, in my opinion. With the new IIDTV and the 
ability to transmit and receive side bands, ihis is an 
area in which Macintosh computers will excel. Home 
networking is another area where I see computers 
headed. No longer will there be one computer per 
home, just as children have their own TVs and 
telephones, they will have their own computers. 
Personal robotics and the ability to program a robot are 
certainly in ihe future. Compression of sound and 
video will certainly impact the future of home 
computers, and again the Macintosh PowerMac will lie 
an excellent choice for that. 

How would you characterize Mac developers' attitudes 
towards the Linux movement? 

Ron: The attitude of some Macintosh developers 

regarding the Linux movement has always been 
humorous to me as people pit the PowerPC-hosted 
Linux against the Intel-hosted Linux. 1 think Lhe average 
Mac programmer has an interest in Linux and sees It as 
an alternative to Windows, hut not to Macintosh While 
rhe PowerPC is a great CPU For Linux, rhere isn’t the 
incentive to change the operating system. It's not worth 
it just to l}e a renegade. 

The open source philosophy lias never Ixxrn limited to 
Linux or to GNl T tools. Netscape is an excellent example 
of open sourcing that benefits the company and the 
developer. I recall a posting written by a developer named 
Simon Fraser in response to another developer who was 
having a problem posting a dialog while handling a drag 
and drop. This problem points out the value of applying 
open source for one application to an entirely different 
application. Fraser advised: 

4 You should avoid posting a dialog while handling the 
drag receive; it’s letter to save state somewhere, and 
process the results of the drag the next time an event is 
handled. That way, you t:an debug the axle, and handle 
user events with no problems. For an example, see the 
News Watcher source code/ 

Metrowerks has been an advocate of open source as well. 
GameCode was released under the Metrowerks Public 
License (MWPL), which is based on the Netscape open 
source model. 


The GameCode web sire is hosted by Soren GrOnbech, 
Lhe original engineer who developed GameCode for 
Metrowerks: < http:// 5 unsite.auc.dk/gamecode/abouLhtml > 

GameCode is an open source, cross-platform 
multimedia development library. GameCode consists 
of three primary parts: an easy-to-use programmers 
APT which lakes care of the basic setup; a number of 
functions to display graphics, play sounds, display 
text, etc.; and a converter-tool which uses a simple 
script-language to convert graphics, sounds and other 
types of resource files. 

Another source for code help is the PowerPIant 
contributed classes. On Lhis site, Macintosh 
PowerPIant developers contribute their useful classes 
to aid other PowerPIant users and create better, more 
useful applications more quickly. You can contribute 
or search Tor these extensions to PowerPIant on the 
Metrowerks web page, 

<http://208.226J 02.11 /powerp[antqry?funaion=form> 

Metrowerks also includes both PowerPIant and 
Metrowerks Standard Libraries in source versions. 
While still copyrighted and non distributable in 
source code form, you can look at Lite code and see 
how it is done and change or alter it if necessary to 
make your own versions. 

Metrowerks has always felt the power to make 
programming decisions should lx- given to programmers. 
Ultimately, this allows for better Macintosh code. 

Wliat emerging technologies do you think will have the 
greatest impact on Mac developers? 

Ron: Fin very bullish on Mac OS X and new 
applications that will be created to take advantage 
of its power and capabilities. I see this as another 
boost to help Apple compete with Microsoft. I’m 
also very excited about Java. 1 don't think any 
language in such a short time has became so 
popular. In hardware, I am excited about 
video/audio compression technology. 

However, what really excites me is the concept of 
personal computer cooperation as used for SET1, 
and the possibilities that other mass cooperation 
could achieve. A cure for cancer running on 
millions of home computers overnight is possible. 
Also, multiple weather forecastings linked together 
over the Internet, allowing for instant access to 
precise readings, could predict a tornado hours 
before it happens. Just about anything is possible, 
and that’s what is so exciting. ESQ 
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www.flashlightdepot.com 


MACWORLD 2000 is the largest Macintosh users show in the world and it will be taking place 

ON THE EVE OF Y2K. THIS ENGRAVED MAG-LiTE FLASHLIGHT IS THE PERFECT SOUVENIR - HANDY FOR 
TRACKING DOWN THOSE LATE NIGHT PARTIES AND ESSENTIAL IF THE POWER COMPANY IS USING WINDOWS. 


Flashlight Depot, your one stop 
shop for pocket lights, tools, and 
emergency or traveling supplies. 
Make sure your office is 
Y2K, make sure you 

your next trip! 



http: / / www.f Las hi ightdepot.com/ m W2 k/ 


only $37.95 


This compact light has du<it buibs that can shine a 6,000 candlepower beam 
across a football fidd or run for 15 nights straight on it's dual alkaline 
batteries. A hit with everyone,from fire fighters to campers, it’s waterproof 
to 100 feet and protected to tough Factory Mutual and CSA standards. It 
has a swiveling head and works as a flashlight or uses a clever 360° dip for 
hands-free operation. Rechargeable version also available! 


A cool way to connect with your friends and family. Only 7 ounces, the 
perfect solution for crowded conferences where cell phone reception 
is poor and you need to stay in contact with your team. A smart choice 
for working outdoors. These trail-blazing two-way radios offer dean, 
dear communication whether ids just for fun or serious business. 


The Leatherman Wave, the next generation of multi-purpose tool has 
arrived with the most features of any Leacherman loo I. A long with easy 
access tb four exterior locking blades, the handles have been rounded 
for a great feet! Perfect traveling companion! 


Always ready when you need it, this powerful light plugs into an 
electrical outlet and stays constantly charged. When a power outage 
occurs it floods the area with light and can even be removed from the 
wall and used as a flashlight to light your way to safety. 
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by Paul E. Seving, Switzerland 


Books on QuickTime 


Discovering QuickTime 
and QuickTime for Java 


QuickTime Developer Series 

This month's review discusses 
the first two hooks in the 
Q Li i e k T i m e Dc v e l o pc r Series. 
QuickTime is a cross-platform (he., 
Mac OS and Windows) multimedia 
software package that is able to 
handle audio, video, vector 
graphics, and many other types of 
digital media in different formats. 
For more information, visit 
http://www.apple.com/quicktime/ - or 
should you consult the QuickTime 
Developer Series? Let's find out. 

The QuickTime Developer Series Is 
a joint effort by Morgan Kaufmann 
(who publishes the books) and Apple 
Computer (who develops QuickTime 
and provides the authors). At the time 
of this writing, three books have been 
published or announced: Discovering 
QuickTime Downer 19991, QuickTime 
for java [Maremaa and Stewart 19991, 
and QuickTime for the Web LG u lie 
1999]. For more information, visit 
http;//www,mkp.com/qt/ and finish this 
article! 

Discovering QuickTime 

George Towner is the author of 
Discovering Qu ick'J / me: A n 

Introduction for Windows and 
Macintosh Programmers. He is 


Apple's lead writer for QuickTime technical 
documentation. 

Discovering QuickTime is organized in iwo parts, 
The World of Quick 7V me and Programming 7 echniques. 
Furthermore, it contains five appendices, an extensive 
glossary, a commented bibliography, an index, and a 
CD, The CD contains lots of sample code, demo 
programs, Inside Macintosh volumes about QuickTime, 
and more. 


The World of QuickTime 

There are six chapters in the first part. They are 
written in a tutorial style, similar to the Getting Started 
column (albeit much longer). They mostly consist of 
text illustrated by well-designed figures or screen shots, 
plus function signatures, type definitions, and code 
snippets written in C. 

The purpose of the first chapter is to give a few 
definitions and to dissect Quickl ime in five layers: User 
Experience, Movie Delivery^ Movie Composition, Media 
Handling, and Media Source . The remaining five 
chapters treat each of these layers in top-down order. 

Even without a background in graphics or sound 
(not to mention multimedia), it is easy to understand 
the text as every term and concept is dearly explained. 
The learning process is additionally supported by the 
Quick Summary sections every chapter ends with that 
list the most important points again. 

To cut a long story short: The World of QuickTime 
is a must-read for every programmer. Even if 
multimedia isn’t your core business, you might still be 
inspired to use QuickTime for your killer About... box 
or for your on-line help. 

Programming Techniques 

The second part encompasses 15 chapters. Chapter 
7 points out where to geL fur liter QuickTime-related 


Paul is an EE student at the Swiss Federal Institute of Technology Zurich (ETHZ) and a student memlier of the IEEE. 2000 Is 
going lo he a very exciting year tor him: he'll finish his M S. thesis in February, turn IS in March, be interviewed for jobs in 
April, ... And throughout that time, he's looking forward to receiving your feedback at psevinc@cc.cth2.ch. 
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information, chapter H explains rhe main differences 
between QuickTime-coding for Mac OS and Windows, 
and chapter 19 casts a glance at QuickTime lor Java. 
Note that other chapters mention some Mac 
OS/Windows differences, too* 

In what order to study chapters 9 u> 18 (or whether 
to study them all in the first place) is up to the reader. 
Some of the topics discussed here have been 
introduced in the first part and are now covered in 
more detail. The code examples are much longer ilian 
before. Again, the explanations are easy to understand 
without insulting the reader’s intelligence. 

QuickTime for Java 

Tom Maremaa and William Stewart are the authors 
of QuickTime for Jam: A Developer Reference. Stewart 
is Apple's chief architect of QuickTime for Java. 
Maremaa is a member of the QuickTime Technical 
Publications team. QuickTime for Java (the 
technology) is an API that enriches the Java platform, 
but it relies on QuickTime being available for the 
underlying operating system (i.c., a JVM alone is not 
enough, so -as of this writing- you can't use 
QuickTime for Java under Solaris, for instance). 

QuickTime for Java (die book) is organized in four 
pans, QuickTime for Java Fundamentals* Tsing 
QuickTime for Java, 7 he QuickTime for Java Sofia are 
A rchitecture , and QuickTime for Java Reference. 
Unlike Discovering QuickTime, it only contains one 
appendix, but also an extensive glossary, a com men led 
bibliography, an index, and a CD with similar contents. 

QTrJ Fundamentals 

The first four chapters are an introduction to 
QuickTime in general and QuickTime lor Java in 
particular There is even a two-page introduction to Java 
for C/C++ programmers. However, in my opinion, the 
reader should know Java before reading this hook. Also, 
the Quickl ime introduction is rather a refresher course 
for those who already have some basic knowledge of 
QuickTime, for instance from consulting the PDF version 
of Inside Macintosh on the accompanying CD, What 1 
dearly missed is a section about die use of Swing vs. 
AWT wiLh QuickTime for Java. 

Using QTfJ 

Chapters 5 to H) introduce QuickTime for Java by 
example. Every chapter shows how to perforin a 
typical task <c,g., playing music). The reader 
encounters few definitions only and lots of source 
code instead. 1 find that this approach gives the reader 
a good idea of QuickTime for Java, even though some 
might prefer to have larger text sections. 


The QTfJ Software Architecture 

Chapters II to 15 are of more technical nature than 
those preceding them. The classes discussed in this 
part perform lower-level tasks (e.g,, timing). Don’t get 
me wrong: neither are these classes unimportant (on 
the contrary), nor is their coverage boring! 

QTfJ Reference 

Chapters 16-45, or in terms of number of pages 
half the book, comprise the reference part. Every 
chapter starts with (lie class hierarchy (the same type 
of diagram used throughout the book) of a package 
and then describes the classes. The forma l of these 
textual descriptions differs from javadoc’s, 1 liked it a 
lot, though, as it allows for very concise treatment. 
Readers who prefer the javadoc style won't be 
disappointed by the CD, 

Conclusion 

The QuickTime Developer Series looks like 
becoming the authoritative source for QuickTime- 
related information — and rightly so. Hath Quicklime 
for Java anti especially Discovering QuickTime could 
be role models for other reference or tutorial material. 
Let’s hope that Apple and Morgan Kaulmann can keep 
up the good work. 

Those of you interested in developing QuickTime- 
based software using the Carbon API should definitely 
start with Discovering QuickTime. Those who intend to 
use the Cocoa API may want to start with QuickTime 
for Java. If the book and the CD don't suffice, you can 
still restart with llie first book. 
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by Jeff CHtes <{.mline@muctech.com> 


Selling WebObjects 


For reasons known only ro Apple itself, the Powers 
that Be have decided not to market WebObjects 
aggressively, at least for the present. The problem this 
poses for woukl-be implemented of course, is that it 
makes WebObjects a tough sell in corporate 
environments, where IT managers may simply not have 
heard of it. This, combined with the anti-Apple 
sentiment which is common in Windows- and Unix- 
centered companies, makes it an uphill battle for 
consultants and programmers to convince the decision- 
makers that WebObjects is the best tool for the job at 
hand. While a few well-placed print ads would go a 
k>ng way toward making this process easier, for the 
lime being we must fend for ourselves as WebObjects 
advocates. The good news is that there are a growing 
number of articles and reports on the Internet which 
give honest evaluations of WebObjects and its place 
among the competition, and these help lend some 
credibility to arguments in favor of WebObjects, it's 
refreshing to see even this limited amount of coverage 
in the mainstream press, even though the reviews 
aren't always positive. For instance, check out the 
articles by PC Week and CNET, and be sure to read the 
Stepwise response to an earlier PCWeek re view, (The 
review itself seems to he gone from PC Week's servers.) 

CNET.com - WebObjects: Apple's best kept secret? 

<http://news.cnet.eom/news/0-1003-200-344957.hlmI7st.neTd.gif.j> 
ZDNet: PC Week: 8 Web App Servers That Deliver 
<http://www.2dnet,com/pcweek/stories/news/0,4153 r 409380 r 00,htmi> 
What's wrong with the PCWeek Application Server shoot-out? 
<http://www.stepwisexom/Aftides/EdiTorial/AppServerShcx)tout.html> 

One of the first questions someone wall ask when 
they hear about WebObjects is, “Who's using it?", 
Apple has a huge list of corporate customers on their 
web site, as well as in-depth articles on how 
WebObjects is being used by AAA P Consumers Digest, 
and GE Capital, and Stepwise has an article on its use 


at the LA. Times (and links to several other users in the 
above-mentioned PCWeek rebuttal article). Also, the 
Fall 1999 issue of the Apple University Arts online 
magazine has several stories of WebObjects 
deployment in university and educational settings. 
Finally, MacCenlra) has a brief article which reiterates 
just how many big-name customers are using 
WebObjects. It s too bad that this comes as a surprise 
even to Apple supporters. 

WebObjects Customers 

<http://www.apple.com/webobjeas/customers.html> 

AAA 

<http://www,applexom/webobjects/customers/aaa.html> 

Consumers Digest 

<http://www.apple.com/webobjects/customers/consumersdigest.html> 

GE Capital 

<http://www.apple.com/webobjeas/customers/gecapital.html> 

The LA. Times introduces a WebObjects-based NBA basketball stats app 
<http://www.stepwise.com/Articles/News/OOPDreams.html> 

Apple University Arts, Fall 1999 
<http://www.apple.com/education/hed/aua0202/> 

They like WebObjects 4, they really like it 
<http://www.maccentrafcom/news/9903/03.webobjects.shtm1> 

After you've impressed potential detractors with all of 
the important users of WebObjects, impress them with all of 
the honors it h;is received recently, including awards from 
the Java Developer's Journal, New Media Magazine, and 
Network Computing. 

Industry Awards for WebObjects 
<http://www.apple.com/webobjects/reaction.html> 

New Media Feature: The Next Big Thing 
<http://newmedi3.com/NewMedia/99/O2/feature/web.html> 

1999 Well-Connected Awards "The 50 Best Products of the Year" 
<http://www.networkcomputing.eom/1010/1010f1.html> 
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Many of lhe resources I've mentioned so far are 
located on Apple's site, and it goes without saying that 
tliis is the best place to start learning about WebObjects 
and what it can do. He sure to explore Apple's 
WebObjects product pages, especially their “Beyond 
Wizardry on the Web" section, which gives a more 
technical overview, (111 leave it to you to decide if it is 
good or bad that all of the screen shots in this section 
are from a Windows machine.) 

Apple - Products - WebObjects 4 

<http://www.apple.com/webobjects/> 

Beyond Wizardry on the Web 
<htlp://www.apple.com/webobjects/bwizard.html> 

On the more technical side, there are two key 
reports from independent parties which give 
WebObjects very high marks. One is an informative 
white paper from ll>C r and the other is a detailed 
benchmark and feature comparison of a number of 
application servers written by TechMetrix. The actual 
report is a bit pricey, but there is an extensive excerpt 
on their web site which is detailed enough to reveal 
that WebObjects basically blew away the competition 
in their tests. This is probably the sirongest objective 
praise I’ve seen for WebObjects. (A good companion to 
Lhis is the article 11 More Than A Movement” by 
Information Week, which gives descriptions of all of 
the major contenders in the application server market.) 
Lastly, see “The Cost of Deploying WebObjects” on the 
Twin Forces web site, which gives a well-thought-out 
analysis of the real-world expense of running a site 
based on WebObjects, and concludes that iL is a lot less 
than you probably think, h also includes a section on 
all of the different things you might want to measure 
in an application server benchmark, and reminds us 
how important it is to notice whether benchmarks arc 
answering the question we really are asking. 

Apple's WebObjects: An IDC White Paper 

<http://www.apple.com/webobjects/whitepaper/index.html> 

TechMetrix: Application Server Report 
<http://www,techmetrix.coni/lab/benchcenter/appserverbench.shtml> 

More Than A Movement 

<http://www.informationweek.com/728/appserv.htm> 

The cost of deploying WebObjects 
<http://www.twinforcescom/tf/docs/WOCosts1.htmi> 

Benchmarking W0 Performance 
<http://www.twinforces.com/tf/docs/W08enchmarking.html> 

With the current popularity of Java, another 
question which will come up often is whether 
WebObjects allows you to utilize Sun T s Enterprise Java 


Beans, The short answer is thai it doesn’t, and the 
latest word is that there are no plans to change this. 
This may seem bad, but really it isn’t. 

In a nutshell, EJBs exist mainly to manage objeci- 
to-database mapping and allow Java programmers to 
partially forget that their objects are made persistent by 
a relational database—to work with them as objects 
rather than data. This is exactly the task taken on by 
the Enterprise Objects Framework (a framework 
included with WebObjects), and as such it makes little 
sense to want EJB integration into WebObjects, 
because it isn’t needed. (It might be possible to retool 
WebObjects rn use EJBs in place of EOF, but this 
appears to be a step in the wrong direction, in terms of 
both design and performance.) There was an 
informative comparison of the two technologies in a 
post to the WebObjects mailing list, and yoit can read 
the archived version on the web. Whether WebObjects 
embraces EJBs in the future may well be a marketing 
decision, as even articles which mostly praise 
WebObjects point to this as a major departure from the 
industry and, therefore, a flaw (sec, for instance, ihe 
CNFT article “WebObjects: Apple’s best-kept secret?” in 
the before mentioned). 

WebObjects archive: EJB 

<http://wvwv.omnigmup.com/01dLook/IVIailArchive/WebObjects/1999/ 

1583,html> 

t hope this is enough to tell you what you need to 
know to give WebObjects a fair evaluation. An encouraging 
note is that an Apple engineer recently remarked that 
where 1999 was the year of hardware at Apple, 2000 will 
lx: the year of software. This is a tall order—1999 gave us 
the Blue and White Yosemite G3, the GJ, DV (Macs, the 
iBook, AirPort, and feather-light PowerBooks. If 2000 even 
comes close, it will be amazing. 

Next month 1 plan to continue with WebObjects, 
covering resources you’ll need when you actually begin 
programming. You can get starred early by reading the 
technical overview which MacTech published in 1997. 

MacTech #13.05: An Introduction to WebObjects 

<http://www.mactech.eom/articles/mactech/Voi.13/13.05/ 
Web0bjects0verview/index.html> 

In the mean time, be sure to check out the links on the 
MacTech Online web pages at <http://www.mactech.com/online/>. 
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PROGRAMMER'S 

BOOKSHEL 


by Paid E. Saving, Switzerland 


Macintosh Windows Integration 


Prfjjminary Remarks 

TtiLs month's btx>k is not alx>ut cross-platform development. As 
a matter of fact, it Isn't about programming at all* Nevertheless, we 
tliink that MncTech readers are interested in reviews of general- 
purpose computer lxx>ks as well Please let us know if we re wrong. 

Something else: While I read a book in its entirety when 
reviewing it, there's no way I can actually test every tip or 
configuration, l neither have the time nor the necessary 
software or hardware resources to do so. Instead, I focus oh 
how the information is presented and assume that, in general, 
it is technically correct. 

The Book 

Macintosh Windows Integration: Integrating your Macintosh 
with Windows 95/98 and Windows NT Environments [Rizzo 19991 
was written by John Rizzo. The \jook has been published by Morgan 
Kaufmann/Academic Press and is based on the author's 
Akic\Wndom.com web site (see http://www.MacWndovvs.eom/J. As its 
title suggests, Macintosh Windows Integration is alxxit using Mac OS 
8 .x and Windows 95/9H/NT side by side. It also deals with think 
party software for this purpose, and there is some information about 
Mac OS X Server, I NTX, Linux and Windows 200(1 

Macintosh Windows Integration consists of five parts, namely 
Integration Basks (about 50 pages), Exchanging Files (100), Cross- 
Platform Neltmrking Infrastructure (100 ), Macintosh and Windows 
NT and Other Servers (20G} T and Using Foreign Operating Systems 
(100). Furthermore, it contains an appendix and a CD. The 
appendix is a c ompilation of BackPanel a column Rizzo used to 
write for MacWeek/eMediaueekly. The CD contains book-related 
freeware, shareware, etc. 

Par i O m 

The first part comprises three chapters and is mostly non¬ 
technical, Those who don’t know vel whether they want to integrate 
their Macs and PCs (or whether to use both platforms in the first 
place) may find it useful, A couple of arguments lx ah in favor of and 
against mixed-platform environments are given, some issues to lx: 
considered during the planning phase are mentioned, etc. But 
overall, part one remains rather superficial. 


Par i Two 

Chapter 4, the first chapter in the second part, deals with 
disks and drives. Rizzo first briefly explains the differences 
between Mac OS and Windows device drivers and formatting. He 
then introduces PC Exchange and shows how it allows to use 
(i.e., read, w rite, format) PC-formatted floppy, ZIP compact, anti 
other disks on a Mac, Nothing new, right? But did you know that 
the Mac OS can mount Windows harddisks, even when they are 
partitioned? How Lo make this happen Ls also described. 
However, Windows users who want to know how to use HFS 
disks and drives get a list of third-party tools only. 

Chapter 5 starts off with a shun background section, too, 
namely alxw.it the differences lictween Mac OS and Windows files. 
Opening and saving Windows files using Mar CXS Rosy 0[mi/Pile 
Translation^ QuickTime and MacUuk Plus is the main topic of this 
chapter. Special emphasis is put on font-related problems and how 
to alleviate them. 

Chapter 6 explains how (i.e., what tex sis to use) to encode and 
compress files on one platform such dial they can lx- attached to an 
e-mail message and decoded on Lite other platform, While 1 
appreciated to learn a little alxtut the different MacBinary and SIT 
iSlufflt) .schemes, I missed some moiv information alxxit the ZIP and 
HQX ( BinHex) fonnacs. By the way, in this duipter, Window's users 
gel as much relevant information as Mac users. 

PARI TllRliE 

Chapter 7, which is a(x>ut local-network technologies, is 
somewhat disappointing. Without overemphasizing the 
shortcomings, I have to say that readers with a computer- 
networks background won’t learn anything new, and readers 
without this background might get a wrong idea - if they get an 
idea at all. This mainly applies to the Ethernet and token ring 
sections. The sections on LocaiTalk, wireless networking and 
network-card installation are OK. 

Chapters 8 and 9 are Mac OS and Windows specific, 
respectively. They cover the base for chapter 10, And together, 
these three chapters provide an introduction to TCP IP 
networking on Macs and PCs, With regard Lo sharing printers and 
files, they also deserilx: how TCP/IP can coexist with other 
network protocols (e g.. AppleTalk). 


Paul is on EE student at the* Swiss Federal Institute of Technology Zurich (ETT1Z) and a student member of the IEEE. He spent his summer preparing 
his exams, doing lots of sports, writing for MacTech, and saving money for a PowerBook. If you want to tell him about your summer, write to 
pse v tmsi ud. ee ,et 1 it ,e h. 
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Pari Four 

Thu subject of the fourth part is the provision and use of .service* 
in (licieto^neoiLs) networks, inducting remote access. Hie ftxrus Is 
on Windows NT Server bused servers and Mac OS based clients. One 
chapter deals with other server software (c.g., Natvll NetWare*), anti 
Windows based c lients are discussed as well Even though most 
sections are addressed lo network administrators, readers wishing to 
connect their Macs and PCs at home get their money s worth. 

By reading pan four's five chapters, it Incomes apparent 
tliat Rizzo is very experienced in setting up mixed-platform 
networks, lie covers different combinations of software, 
discusses cable issues, and even explains what bugs to expert 
and I iow to circumvent them. 

Part Five 

The content of chapter 16 is similar to what one would expect 
in an article abouL running Windows on Mites, first, there Ls a 
comparison of emulators and coprocessor raids in general Ihen, 
different prcxluets are presented (among others StrjWimfatt\ 
Virtual F<1 and OwtytpPCX including installation and configuration 
tips. Finally* a few pages in this rather big chapter also present 
products that allow to run the Mac OS on Windows. Windows on 
UNIX, etc. Readers interested in benchmarks won't find any, only 
hints at which product performs better under whit conditions. 

fm afraid that chapter 17, despite iis interesting tide Nvttwrk. 
Ajtfrfkatim Sharing & Ihin Clients, isn't much more than a product 
overview in which Timbuktu Pro gets the biggest share. (Don't get 
me wrong, the last sentence is not directed against Neltpia. } 


In the very' last drapier, tlie reader learns about using Mac mice, 
keyboaals and monitors with PCs and vice versa, Both preTISB and 
USB devic es are covered. 

CONOJUSKMW 

Macintosh Window s Integration is a lx>ok from w hich Mac 
users will gain more Elian Windows users. Rizzo is quite good at 
explaining software features, at giving installation <& configuration 
instructions, and at providing practical tips in general But when 
li comes to theory, his choices of what to include, what to leave 
out, and how to oiganize the text leave a little to be desired. 
Fortunately (for both the author and the reader), Macintosh 
Windows Integration is practice oriented. 

Most chapters have a corresponding web page (witliin 
MacWinclows.com) (or inlbrnmtioo updates. So you might find the 
answer to a question without consulting the lxx>k However, people 
who often ftave 10 deal with both OSes should seriously consider 
getting a copy. Also those who decide to get rid of one OS in favor 
of the txher, but want to keep tlieir files and peripherals. 

AtXNOWifixiMFFsrrs 

I)ani Seelhofer and Naso Aianasoski helped me to get rid of 
Germanisms, If some are left, it s not tlieir fault, 

References 

I Rizzo 1999! RIZZO, John. - Macintosh Windows Integration, 
Integrating \x>ur Macintosh with Windows 95/98 and Windous NT 
limironmenis Morgan Kaufmann/Academic Press, 1999. BS3 
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REALbasic 



test New Product 


Most Innovative 



The visual, object-oriented 
BASIC development 
environment for Macintosh 0 


* 

I Apple 
Design 
Award 


1 YW IU'M!ilU. : P 


Best Macintosh 
User Experience 



)ur award-winning IDE is the most advanced BASIC development tool available for the 
Macintosh. Build compiled applications faster and easier. It's easy enough for beginners and 
>owerful enough for developers to use. 


100% Object-Oriented BASIC with classes, constructors, 
destructors, inheritance, properties, methods, virtual 
methods, multi-threading, and automatic garbage 
collection —even more object-oriented than C++! 

Build your applications on the Macintosh and deliver on 
both Macintosh (68k and PowerPC) and Windows (95, 
98 and NT) — including support for conditional 
compilation.* 

Port VB projects faster and easier by importing VB forms 
and modules. 

The debugger supports breakpoints, step over, step in, 
and step out — track down bugs faster and easier. 


• Create Internet-enabled applications using the TCP/IP 
socket tool. 

• Powerful multimedia tools with extensive QuickTime 
support and a Sprite animation engine. 

• Easily localize your applications including double-byte 
character support. 

• Extend functionality with PowerPC Shared Libraries, 
REALbasic native plugins, XCMDs and AppleScript. 

• Single database API with support for Oracle, Microsoft 
SQL Server, 4D Server, Dtf, PostgreSQL, OpenBase, or 
any ODBC-compliant database. Includes a single-user 
SQL database engine. 


3 REAL Software, Inc. 

j - M : - - . ... tM i mk . ii n iiUi ii ■ 

download a FREE trial version NOW! at www.realbasic.com or call 512.263.1233 for more information 

* Apple Design Awards awarded to REALbasic T.O. Congratulations Geoff and Jeannie! **MacWorld rating awarded to REALbasic 2*0.2. 

4Windows compilation and database support require Professional Edition. REALbasic is a trademark of REAL Software, Inc, 











Mac deve 
can't be wrong 


CodeWarrior is the only serious choice 
for professional Mac* development. 

Chances are* every Mac program you 
use was created using Code Warrior. In 
fact, more than 90% of all commercial 
Mac OS applications are built with 
CodeWarrior. 

Built with the Mac developer in mind. 

The Code Warrior Integrated Develop¬ 
ment Environment (IDE) has won every 
major award given to Mac development 
software. It's the worldwide standard for 



Codt'Wutrior keeps you ahead of the curve with 
AftiWf find future OS X support. 


creating Mac software, and continues to 
lead the industry. 

Check out these CodeWarrior benefits: 

✓ The siaie-of-lhe-an IDE shortens 
your development time 

*/ Every filing you need in one box... 

project manager* editor, compilers, 
debuggers* linkers, assemblers, 
profilers, a file compare utility, our 
world-class framework FowerPlant? 
and the [lexibility to plug-in ihird 
party components. 

f Use the same familiar toolset 

to develop for all the major 
platforms, including Windows® 

I mux, Solaris? game consoles 
and embedded platforms, 

✓ Tightest 1SO/LEC C++ standards 
compliance 

if C, C++ and Java” support. 


FA 


metrowerks 


CodeWarrior 

for Mac OS 


Go with the world-class standard. 

Use the same powerful, flexible, 
fast toolset that built world-class 
apps like Adobe* Photoshop* and 
Neiscape* Navigator* 

See for yourself. 

Don't just lake our word Tor it. 

Get your FREE* 10-day evaluation 
edition of CodeWarrior for Mac 03 
and put it to the lest. 



; Discover why over 
I 200,000 programmers 
! worldwide use CodeWarrioi 

Call today or order online 
FREE 30-day evaluation 

www.metrowerts.coM/gfl/mactecIi 

1 - 800 - 377-5416 

‘Non refundable shipping and handling of $195 
per CD applies, plus state sales tax if applicable. 


Hurry! This offer expires 4/30/2000. 




© 1999-2000 Melu/wrrks All rights reserved Melrrwerks. the Matrmwerits logo and CodeWarrior are legisiered trademarks, am) PnwailEant is a trademark of Metrowerks Inc All other products a/e trademarks ol their 
respective companies All prices are in US dollars: offer good in (JS and Canada only CodeWamnr lor Mac OS. Professional Edition, targets Mae OS and Windows 95/98/NT only, ottroi targets available separately. 







































